EDGAR 财务数据 MCP 服务端

关键词

EDGARSEC财务数据JSON-RPCLLM 集成

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个基于 MCP（Model Context Protocol）的后端服务器，用于向大语言模型客户端提供可调用的工具，核心功能包括从 SEC EDGAR 获取 filings 元数据、完整财务数据和特定指标的查询能力。
    • 服务器通过标准 MCP 接口暴露三个工具：get_filings、get_financials、get_metric，便于 LLM 客户端以统一的请求-响应格式访问数据。

  • 主要功能点

    • MCP 工具集成：实现 get_filings、get_financials、get_metric 三个工具及其输入输出规范。
    • EDGAR 数据管线：内置实现能拉取并解析 EDGAR 的 10-Q/10-K/8-K 数据，提供结构化的元数据与财经事实。
    • 跨组件协作：包含用于 Excel 的集成路径、以及辅助脚本用于缓存、日志和监控。
    • JSON-RPC 交互：服务器按照 MCP 标准接收请求并返回 JSON-RPC 风格响应。
    • 本地/stdio 模式运行：通过标准输入输出（stdio）与客户端对接，支持与 Claude Code 等集成方式协作。

  • 安装步骤

    • 确保 Python 环境就绪（推荐 Python 3.8+）。
    • 安装依赖：在仓库根目录执行依赖安装，确保包含 mcp 库及所需依赖项。
    • 在本地或服务器直接运行服务器脚本，服务器会通过 stdio 与客户端通信。

  • 服务器配置（MCP 客户端连接所需的最小信息）

    • 该 MCP 服务器需要与客户端（如 Claude Code）通过 MCP 约定建立连接，客户端需配置服务器信息以便启动并连接。以下为示例 JSON 配置要点（请以实际路径替换占位符）： { "server_name": "edgar-financials", "command": "python", "args": ["mcp_server.py"], "env": { "PYTHONPATH": "<仓库根目录路径>" } // 说明：该配置用于告知 MCP 客户端以子进程方式启动服务器，并通过标准输入/输出进行 JSON-RPC 交互。 }

  • 基本使用方法

    • 启动方式
      • 在支持 MCP 的工作流中，按客户端配置要求启动服务器进程，客户端将通过标准输入输出与服务器进行 JSON-RPC 请求/响应。
    • 常用请求
      • 获取 filings 元数据：get_filings(ticker, year, quarter)
      • 获取完整财务数据：get_financials(ticker, year, quarter, full_year_mode=False|True, source="auto"|"8k")
      • 获取单个指标：get_metric(ticker, year, quarter, metric_name, full_year_mode=False, date_type="Q"|"YTD"|"FY", source="auto"|"8k")
    • 运行与测试
      • 通过 MCP 客户端发送请求，服务器返回 JSON-RPC 风格的响应，包含数据与可能的错误信息或元数据。

服务器信息

访问项目