AI导哈

金融数据分析服务

一个提供金融数据和SEC文件分析的MCP服务器，支持公司信息、财务报告和市场数据的获取与分析。

  • by Agitatree
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Agitatree/stock_mcp

使用说明

库存MCP服务器

MCP（模型上下文协议）服务器，使用以下方式提供财务数据和SEC文件分析 edgartools 和 yfinance.

特性

  • SEC数据：获取公司信息、最近和历史文件（10-K、10-Q、8-K），并提取具体文本（风险因素、MD&A）。
  • 财务数据：检索标准化的资产负债表、损益表和现金流量表，支持历史数据和多期拼接（趋势分析）。
  • 市场数据：获取实时股票价格和历史OHLCV数据。

先决条件

  • Python 3.10+
  • SEC EDGAR身份的有效电子邮件（SEC API要求）。

安装

  1. 克隆此存储库。
  2. 创建虚拟环境：
    python3 -m venv venv
source venv/bin/activate
  3. 安装依赖项：
    pip install -r requirements.txt

用法

此MCP服务器设计为由MCP客户端（例如Gemini CLI、Claude Desktop）运行。在客户端中配置后（请参阅下面的“客户端配置”），客户端将根据需要自动启动和停止此服务器。

在服务器可以运行之前（无论是通过客户端还是手动），您需要设置环境变量。 复制 .env.example 将文件转换为名为的新文件 .env:

cp .env.example .env

然后，编辑 .env 归档并替换 "YOUR_NAME your.email@example.com" 使用您的真实姓名和电子邮件 EDGAR_IDENTITY。这是美国证券交易委员会要求的请求。

可选地，如果您计划使用经济指标，您还可以设置 FRED_API_KEY 在你的 .env 文件。您可以从圣路易斯联邦储备银行网站获取FRED API密钥： https://fred.stlouisfed.org/docs/api/fred/

客户端配置

要将此服务器与MCP客户端一起使用，您需要配置它们以运行 run_server.sh 脚本。确保您提供 绝对路径 到脚本。

Codex CLI(config.toml)

此文件的默认位置为 ~/.codex/config.toml.

将以下内容添加到您的 config.toml:

[mcp_servers.stock-mcp]
command = "/absolute/path/to/stock_mcp/run_server.sh"
args = [] # Required even if empty

双子座(settings.json)

此文件的默认位置为 ~/.gemini/settings.json.

将以下内容添加到您的双子座 settings.json （或 mcp.json 取决于您的设置）：

{
  "mcpServers": {
    "stock-mcp": {
      "command": "/absolute/path/to/stock_mcp/run_server.sh",
      "args": []
    }
  }
}

可用工具

工具 说明
get_company_info 基本信息（CIK、行业、财政年度末）。
get_filings 列出带有表单类型、年份和日期范围过滤器的文件。
get_financial_statement 获取资产负债表、损益表或现金流（支持历史和趋势）。
get_latest_filing_text 从文件中提取文本（例如，10-K中的“风险因素”）。
get_insider_trades 追踪最近的内幕交易活动（表4）。
get_stock_current_price 实时股票价格和每日统计数据。
get_stock_history 特定时期的历史市场数据（OHLCV）。
get_company_news 最新新闻标题、出版商和链接。
get_financial_ratios 关键估值（市盈率、PEG）和盈利能力指标。
get_profitability_trend 美国证券交易委员会文件中的历史毛利率、营业利润率和净利润率。
get_financial_health_trend 历史债务/股权和流动性比率。
get_cash_flow_trend 历史自由现金流、资本支出和股东回报。
get_technical_indicators RSI、MACD、布林带和SMA计算。
get_analyst_recommendations 华尔街共识评级和价格目标。

依赖项

  • edgartools：强大的SEC文件解析功能。
  • yfinance：市场数据提供商。
  • mcp：模型上下文协议SDK。

手动服务器执行（用于开发/调试）

这些说明用于手动启动服务器，对于开发、测试或您更喜欢在MCP客户端之外管理服务器进程非常有用。当配置了MCP客户端时，客户端将自动为您启动和停止服务器。

直接运行服务器

要直接启动MCP服务器，然后您可以使用MCP客户端（例如，另一个MCP主机Claude Desktop）连接到该服务器：

./run_server.sh

与Inspector一起运行

要启动MCP服务器并使用MCP检查器在web浏览器中检查其活动，请执行以下操作：

./run_inspector.sh

检查器界面将在浏览器中打开。按 Ctrl+C 在终端中停止它。

相关 MCP