Introduction 📣
2025.04.13
6
Python金融数据SEC EDGARAI 集成金融服务
SEC EDGAR MCP 是一个开源的 MCP 服务器，用于将 AI 模型连接到美国证券交易委员会（SEC）的 EDGAR 数据库。EDGAR 是 SEC 的主要系统，用于公司提交官方文件，包含数百万份文件，通过提供对公司财务信息的免费公开访问，提高了证券市场的效率、透明度和公平性。该项目使这些公开的公司数据可供 AI 助手（如 LLMs）用于金融研究、投资洞察和公司透明度等用例。
View on GitHub
Overview
基本能力
产品定位
SEC EDGAR MCP 是一个连接 AI 模型与 SEC EDGAR 数据库的工具，旨在提供金融数据访问和分析能力。
核心功能
- 公司文件检索：获取公司的提交历史（如 10-K、10-Q 等文件）。
- 财务概念查询：获取特定财务概念（如 XBRL 标签）的详细数据。
- 公司事实检索：获取公司所有可用的财务事实（完整的 XBRL 数据集）。
- XBRL 框架查询：查询跨公司或时间段的财务概念数据。
适用场景
- 金融研究：用于分析公司的财务健康状况。
- 投资洞察：帮助投资者获取最新的公司财务数据。
- 公司透明度：提高公司财务信息的透明度和可访问性。
工具列表
- get_submissions：获取公司的提交历史（文件历史）。
- get_company_concepts：获取公司特定财务概念的详细数据。
- get_company_facts：获取公司所有可用的财务事实。
- get_xbrl_frames：查询跨公司或时间段的财务概念数据。
常见问题解答
- 如何获取公司的 CIK：可以使用 SEC 的 CIK 查找工具（https://www.sec.gov/edgar/searchedgar/cik）。
- 如何配置 SEC EDGAR API 访问：需要在
.env文件中设置SEC_API_USER_AGENT。 - 如何调用工具：通过 MCP 的 JSON-RPC 接口调用工具。
使用教程
使用依赖
- 确保已安装 Python 3.9+。
- 安装依赖包：
bash pip install mcp secedgar
安装教程
- 克隆仓库：
bash git clone https://github.com/yourusername/sec-edgar-mcp.git cd sec-edgar-mcp - 配置 SEC EDGAR API 访问：
在项目目录中创建
.env文件并添加：SEC_API_USER_AGENT="Your Name ([email protected])" - 启动 MCP 服务器：
bash mcp install sec_edgar_mcp/server.py --env-file .env --name "SEC EDGAR MCP Server"
调试方式
- 检查服务器日志以确保服务器已启动。
- 使用 MCP CLI 或 AI 平台连接到服务器并测试工具调用。
json { "jsonrpc": "2.0", "id": 42, "method": "tools/call", "params": { "name": "get_submissions", "arguments": { "cik": "0000320193" } } }