plainyogurt21-sec-edgar-mcp

Name: plainyogurt21-sec-edgar-mcp
Author: smithery.ai

远程服务

github.com/plainyogurt21金融数据160 周前更新

代码仓库

关于 plainyogurt21-sec-edgar-mcp

plainyogurt21-sec-edgar-mcp 是面向财务研究人员等用户的开源 MCP 服务，用于处理上市公司申报文件。它从 SEC EDGAR 获取官方数据并解析 XBRL 数值，返回精确数据及文件引用。

主要功能

01查询公司及公司事实数据
02获取近期申报和文件内容
03分析 8-K 并提取文件章节
04通过 XBRL 解析财务报表
05查看 Form 3、4、5 交易
06返回精确数值及 SEC 引用

适用场景

01查找公司的最新 10-K
02核实已披露的财务指标
03审阅内部人交易
04提取 SEC 申报文件中的章节

MCP 相关

该服务向 MCP 客户端提供 SEC EDGAR 公司、申报、财务和内部人交易工具。结果包含 SEC 文件引用，财务报表数据通过直接解析 XBRL 获得。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp

一键复制安装命令

Claude CodeTerminal

claude mcp add --transport http ai-smithery-plainyogurt21-sec-edgar https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp

Cursor.cursor/mcp.json

{"mcpServers":{"ai-smithery-plainyogurt21-sec-edgar":{"type":"http","url":"https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp"}}}

在 Cursor 中打开

VS Code.vscode/mcp.json

{"servers":{"ai-smithery-plainyogurt21-sec-edgar":{"type":"http","url":"https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp"}}}

在 VS Code 中打开

Claude Desktopclaude_desktop_config.json

{"mcpServers":{"ai-smithery-plainyogurt21-sec-edgar":{"type":"http","url":"https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json

{"mcpServers":{"ai-smithery-plainyogurt21-sec-edgar":{"serverUrl":"https://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://server.smithery.ai/@plainyogurt21/sec-edgar-mcp/mcp需要授权

工具

详细介绍

SEC EDGAR MCP

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

重要

EDGAR® 和 SEC® 是美国证券交易委员会的商标。本开源项目与美国证券交易委员会无关联，也未获得其认可。

简介 📣

SEC EDGAR MCP 是一款开源 MCP 服务，可将 AI 模型接入丰富的 SEC EDGAR 文件数据集。EDGAR（电子数据收集、分析和检索系统）是美国 SEC 为公司提交正式文件而设立的主要系统。它包含数百万份文件，通过免费开放企业财务信息，提升“证券市场的效率、透明度和公平性”。本项目让 AI 助手（大模型）能够访问这些上市公司公开数据，用于金融研究、投资洞察和企业透明度等场景。

SEC EDGAR MCP 服务采用 Model Context Protocol (MCP)——这项开放标准“可实现大模型应用与外部数据源及工具之间的无缝集成”——提供一套全面的工具，用于访问 SEC 文件数据。底层通过 EdgarTools Python 库从 SEC 官方来源获取数据，并直接解析 XBRL，以确保财务数据精确无误。这意味着 AI Agent 可以提出“Apple 最新的 10-K 文件是什么？”或“显示 Tesla 最新 10-K 中的准确营收”等问题，MCP 服务会直接从 EDGAR 官方数据中检索答案，并提供完整且准确的文件引用。

提示

如果您使用本软件，请按照 CITATION.cff 中的说明引用，或使用以下 APA 格式条目：

Amorelli, Stefano (2025). SEC EDGAR MCP (Model Context Protocol) Server [Computer software]. GitHub. https://github.com/stefanoamorelli/sec-edgar-mcp

用法 🚀

SEC EDGAR MCP 服务运行后，你可以使用任何兼容 MCP 的客户端（例如 AI 助手或 MCP CLI 工具）连接到它。客户端会发现可用的 EDGAR 工具，并调用这些工具获取 SEC 文件中的实时数据。例如，AI 助手可以使用此服务获取某家公司的近期文件，或查询特定财务指标，无需手动搜索网页。

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

演示：以下演示展示了 AI 助手如何使用 SEC EDGAR MCP 获取 Apple 的最新文件和财务事实（点击观看视频）：

SEC EDGAR MCP - 演示 - 观看视频

在上面的演示中，助手使用 SEC EDGAR MCP 工具获取 Apple 的文件和财务数据，展示了如何实时获取并呈现 EDGAR 信息，同时确保数据精确，并附上文件引用。📊

文档 📚

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

架构 🏗️

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 官方数据。

参考资料 📚

SEC EDGAR – 关于 EDGAR，SEC.gov（2024）。EDGAR 是 SEC 用于存储公司电子申报文件的数据库。
Model Context Protocol (MCP) – 官方文档和 SDK。ModelContextProtocol.io——用于将大模型连接到工具的开放标准。
EdgarTools – 用于访问 SEC EDGAR 数据的现代 Python 库，具备强大的申报文件分析能力。GitHub 仓库，文档。