STARWARCLOUD STARWAR.AI
返回市场
证券EDGAR-MCP

证券EDGAR-MCP

作者：stefanoamorelli173 星标更新：2025-10-20
安装使用来源：spider==github.com

项目介绍

<div align="center">

SEC EDGAR MCP

mcp-name: io.github.stefanoamorelli/sec-edgar-mcp

</div> <p align="center"> <img alt="License: AGPL-3.0" src="https://img.shields.io/badge/license-AGPL--3.0-blue.svg" /> <img alt="Python: 3.11+" src="https://img.shields.io/badge/python-3.11+-brightgreen.svg" /> <img alt="Platform: Windows | Mac | Linux" src="https://img.shields.io/badge/platform-Windows%20%7C%20Mac%20%7C%20Linux-lightgrey.svg" /> <img alt="Build Status" src="https://img.shields.io/badge/build-passing-brightgreen.svg" /> <a href="https://pypi.org/project/sec-edgar-mcp/"><img alt="PyPI" src="https://img.shields.io/pypi/v/sec-edgar-mcp.svg" /></a> <a href="https://anaconda.org/stefanoamorelli/sec-edgar-mcp"><img alt="Conda Version" src="https://img.shields.io/conda/vn/stefanoamorelli/sec-edgar-mcp.svg" /></a> <a href="https://mseep.ai/app/0132880c-5e83-410b-a1d5-d3df08ed7b5c"><img alt="Verified on MseeP" src="https://mseep.ai/badge.svg" /></a> <a href="https://doi.org/10.5281/zenodo.17123166"><img alt="DOI" src="https://zenodo.org/badge/DOI/10.5281/zenodo.11723166.svg" /></a> </p>

https://github.com/user-attachments/assets/d310eb42-b3ca-467d-92f7-7d132e6274fe

[!IMPORTANT] EDGAR® 和 SEC® 是美国证券交易委员会的注册商标。这个开源项目与美国证券交易委员会无关，也没有得到其批准。

简介 📣

SEC EDGAR MCP 是一个开源的 MCP 服务器，它连接 AI 模型到丰富的 SEC EDGAR 文档 数据集。EDGAR（电子数据收集、分析和检索）是美国证券交易委员会的主要系统，用于公司提交官方文件。它包含了数百万份文件，并通过提供免费的公共访问权限来提高证券市场的效率、透明度和公平性。该项目使这些公开公司的数据对 AI 助手（LLMs）可用，可用于财务研究、投资见解和企业透明度案例。

使用 模型上下文协议（MCP） —— 一个开放标准，能够“无缝集成 LLM 应用程序和外部数据源及工具”—— SEC EDGAR MCP 服务器暴露了一整套工具，用于访问 SEC 文件数据。在后台，它利用了 EdgarTools Python 库 来从官方 SEC 源获取数据，并进行直接的 XBRL 解析以确保精确的财务信息。这意味着 AI 代理可以提出诸如“苹果公司的最新 10-K 文件是什么？”或“展示特斯拉公司最新 10-K 文件中的确切收入”等问题，而 MCP 服务器将直接从 EDGAR 的官方数据中准确地检索答案并附上文件引用。

[!TIP] 如果您使用此软件，请使用以下 DOI 引用或参考 CITATION.cff：

DOI

APA 引用：

Amorelli, S. (2025). SEC EDGAR MCP (Model Context Protocol) Server (Version 1.0.6) [计算机软件]. Zenodo. https://doi.org/10.5281/zenodo.17123166

BibTeX：

@software{amorelli_sec_edgar_mcp_2025,
  title = {{SEC EDGAR MCP (Model Context Protocol) Server}},
  author = {Amorelli, Stefano},
  version = {1.0.6},
  year = {2025},
  month = {9},
  url = {https://doi.org/10.5281/zenodo.17123166},
  doi = {10.5281/zenodo.17123166}
}

使用方法 🚀

一旦 SEC EDGAR MCP 服务器运行起来，您可以使用任何兼容 MCP 的客户端（如 AI 助手或 MCP CLI 工具）连接到它。客户端会发现可用的 EDGAR 工具，并可以调用它们来获取 SEC 文件的实时数据。例如，AI 助手可以使用此服务器来获取公司的最近文件或查询特定的财务指标，而无需手动网络搜索。

对于全面的指南、示例和工具文档，请访问 SEC EDGAR MCP 文档。

Docker 配置

要使用 Docker 运行 SEC EDGAR MCP，请在您的 MCP 客户端中添加以下配置：

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=您的姓名 (name@domain.com)",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ],
      "env": {}
    }
  }
}

[!NOTE] -i 标志是必需的，以保持交互模式下的 STDIN 打开状态，这对于 MCP 服务器接收来自客户端的 JSON-RPC 消息至关重要。

演示：这里有一个演示，展示了 AI 助手如何使用 SEC EDGAR MCP 获取苹果公司的最新文件和财务事实（点击观看视频）：

<div align="center"> <a href="https://www.loom.com/share/17fcd7d891fe496f9a6b8fb85ede66bb"> <img style="max-width:300px;" src="https://gips2.baidu.com/it/u=1724035137,3445208223&fm=3081&app=3081&f=GIF?w=513&h=360"> </a> <a href="https://www.loom.com/share/17fcd7d891fe496f9a6b8fb85ede66bb"> <p>SEC EDGAR MCP - 演示 - 观看视频</p> </a> </div>

在上述演示中，助手使用 SEC EDGAR MCP 工具获取苹果公司的文件和财务数据，展示了如何实时获取和呈现 EDGAR 信息，具有精确的数值精度和文件引用。📊

文档 📚

对于安装和设置说明，请访问 SEC EDGAR MCP 快速入门指南。对于完整的工具文档、使用示例和配置指南，请访问 SEC EDGAR MCP 文档。

在本地运行文档

要在本地运行文档以供开发或离线访问：

# 全局安装 Mintlify CLI
npm i -g mintlify

# 导航到文档目录
cd docs

# 启动开发服务器
mintlify dev

文档将在 http://localhost:3000 上可用。您对文档文件所做的任何更改都会实时反映出来。

架构 🏗️

SEC EDGAR MCP 服务器作为 AI（MCP 客户端）和 SEC 的 EDGAR 后端之间的中间人：

  • 🔸 MCP 客户端：可以是 AI 助手（如 Claude 或其他兼容 MCP 的工具），或者任何支持 MCP 协议的应用程序。客户端发送 JSON-RPC 请求来调用工具并接收 JSON 结果。

  • 🔸 MCP 服务器（SEC EDGAR MCP）：此服务器定义了全面的 EDGAR 工具并处理传入请求。它包括：

    • 公司工具：CIK 查找、公司信息和公司事实
    • 文件工具：最近的文件、文件内容、8-K 分析和部分提取
    • 财务工具：直接解析 XBRL 的财务报表，确保精确度
    • 内部交易工具：分析 Form 3/4/5 并提供详细的交易数据

  • 🔸 EDGAR 数据源：服务器使用 edgartools Python 库 访问：

    • SEC EDGAR REST API：官方 SEC 端点，用于公司数据和文件元数据
    • 直接 XBRL 解析：使用正则表达式模式从 SEC 文件中直接提取财务数据，确保精确的数值精度
    • 文件内容：下载并解析完整的 SEC 文件（.txt 格式）

关键特性：

  • 确定性响应：所有工具都包含严格的指令，防止 AI 出现幻觉，并确保响应仅基于 SEC 文件数据
  • 精确度：财务数据保持精确的数值精度（不进行四舍五入），如同向 SEC 提交的一样
  • 文件引用：每个响应都包含可点击的 SEC URL，以便独立验证
  • 灵活的 XBRL 提取：使用模式匹配查找财务概念，而不是硬编码映射

工作原理：MCP 客户端发现可用的工具（公司查找、财务报表、内部交易等）。当被调用时，每个工具从 SEC 源获取数据，应用确定性的处理规则，并返回带有文件引用的结构化 JSON。这确保了 AI 响应的准确性、可验证性和基于官方 SEC 数据。

集成

默认情况下，MCP 服务器配置为使用 stdio 传输。与平台如 Dify 的集成需要切换到 流式 HTTP，或可能的 SSE，具体取决于所需的 向后兼容性。可以通过向 server.py 传递 --transport streamable-http 参数启用流式 HTTP。监听的主机和端口默认为 0.0.0.0 和 9870。这些值可以通过 --host 和 --port 地址覆盖。

注意：服务器没有身份验证，HTTP 暴露尚未针对任何特定威胁模型进行测试或保证。明智的做法是将此类用途限制在私有、防火墙网络或私有云网络中。如果没有额外的安全保护措施，直接从整个互联网访问服务器是不明智的。

参考文献 📚

  • SEC EDGAR – 关于 EDGAR，SEC.gov (2024)。EDGAR 是 SEC 的数据库，用于电子公司文件。

  • 模型上下文协议（MCP） – 官方文档和 SDK。ModelContextProtocol.io – 连接 LLM 到工具的开放标准。

  • EdgarTools – 一个现代的 Python 库，用于访问 SEC EDGAR 数据，具有强大的文件分析能力。GitHub 仓库，文档。

贡献者 🤝

感谢所有帮助改进此项目的贡献者！

<a href="https://github.com/stefanoamorelli/sec-edgar-mcp/graphs/contributors"> <img src="https://contrib.rocks/image?repo=stefanoamorelli/sec-edgar-mcp" /> </a>

许可证 ⚖️

本开源项目根据 GNU Affero 通用公共许可证 v3.0 (AGPL-3.0) 授权。这意味着：

  • 您可以使用、修改和分发此软件
  • 如果您修改并分发它，必须在 AGPL-3.0 下发布您的更改
  • 如果您在一个服务器上运行修改过的版本，必须向用户提供源代码
  • 详情请参阅 LICENSE 文件

对于商业许可选项或其他许可问题，请联系 stefano@amorelli.tech。

© 22025 Stefano Amorelli – 根据 GNU Affero 通用公共许可证 v3.0 发布。祝您愉快！🎉