英語 |中文

開源金融数据 MCP / HTTP 服务,面向 AI Agent、量化脚本和普通后端集成。

中文

这是什么

stock-mcp 是一个开源金融数据服务，提供两套对外接口：

• MCP:給 Claude Desktop、Cursor、DeerFlow、各类 Agent 使用
• HTTP API：给普通后端、脚本和服务直接调用

它的定位不是“给投资建议”，而是提供：

• 稳定的数据源接入
• 标准化的金融工具能力
• 適合 Agent 使用的 MCP tool / artifact 輸出
• 適合コード执行工作流的 CSV / JSON 数据导出

一键启动

如果你只是想先把服务跑起来，最短路径就是：

启动后默认可访问：

• http://127.0.0.1:9898/health
• http://127.0.0.1:9898/docs
• http://127.0.0.1:9898/mcp

默认 Docker 栈会一起启动:

• stock-mcp
• redis
• postgres

默认端口：

• stock-mcp: 127.0.0.1:9898
• postgres: 127.0.0.1:15432

说明：

• 15432 是为了避免占用你本机已有的 5432
• 容器内部仍然使用 postgres:5432
• 如果你想修改宿主机映射端口，改 DOCKER_POSTGRES_PORT 即可

核心功能

1.市场数据

• A 股、美股、ETF、指数、加密資産行情
• 日线 / 分时 / K 线数据
• 多市场 ティッカー解析与标准化
• 多数据源回退

2.技术分析

• RSI、MACD、均线、布林带等常见指標
• K 线形态识别
• 支撑 / 压力位分析
• 趋势与动量辅助分析

3.基本面与研究

• 估值与基础财务指标
• 美股宏观和行业研究工具
• 基于 Tavily 的统一新闻检索
• 资金流与筹码分布

4.公告与文档

• SEC / EDGAR提出書類
• A 股公告处理
• ドキュメント チャンク / マークダウン / 構造化提取

5.Agent / Code Workflow 友好能力

• MCP tools 统一注册
• MCP artifact 減载,避免把大 blob 直接塞进模型上下文
• code-export HTTP 接口,可直接导出 CSV / JSON 给コード执行型 agent

支持的主要数据源

国内源：

• Tushare

Stock MCP

中文

这是什么

stock-mcp 是一个开源金融数据服务，提供两套对外接口：

• MCP：给 Claude Desktop、Cursor、DeerFlow、各类 Agent 使用
• HTTP API：给普通后端、脚本和服务直接调用

它的定位不是“给投资建议”，而是提供：

• 稳定的数据源接入
• 标准化的金融工具能力
• 适合 Agent 使用的 MCP tool / artifact 输出
• 适合代码执行工作流的 CSV / JSON 数据导出

一键启动

如果你只是想先把服务跑起来，最短路径就是：

git clone https://github.com/yourusername/stock-mcp.git
cd stock-mcp
cp .env.example .env
docker compose up -d --build

启动后默认可访问：

• http://127.0.0.1:9898/health
• http://127.0.0.1:9898/docs
• http://127.0.0.1:9898/mcp

默认 Docker 栈会一起启动：

• stock-mcp
• redis
• postgres

默认端口：

• stock-mcp: 127.0.0.1:9898
• postgres: 127.0.0.1:15432

说明：

• 15432 是为了避免占用你本机已有的 5432
• 容器内部仍然使用 postgres:5432
• 如果你想修改宿主机映射端口，改 DOCKER_POSTGRES_PORT 即可

核心功能

1. 市场数据

• A 股、美股、ETF、指数、加密资产行情
• 日线 / 分时 / K 线数据
• 多市场 ticker 解析与标准化
• 多数据源回退

2. 技术分析

• RSI、MACD、均线、布林带等常见指标
• K 线形态识别
• 支撑 / 压力位分析
• 趋势与动量辅助分析

3. 基本面与研究

• 估值与基础财务指标
• 美股宏观和行业研究工具
• 基于 Tavily 的统一新闻检索
• 资金流与筹码分布

4. 公告与文档

• SEC / EDGAR filings
• A 股公告处理
• 文档 chunk / markdown / 结构化提取

5. Agent / Code Workflow 友好能力

• MCP tools 统一注册
• MCP artifact 减载，避免把大 blob 直接塞进模型上下文
• code-export HTTP 接口，可直接导出 CSV / JSON 给代码执行型 agent

支持的主要数据源

国内源：

• Tushare
• Akshare
• Baostock

国外源：

• Yahoo / yfinance
• Finnhub
• Alpha Vantage
• Twelve Data
• FRED
• CCXT
• Crypto
• EDGAR

HTTP API 能做什么

当前 HTTP 路由主要分为这些组：

• /api/v1/market/*
  • 行情、K 线、技术指标、市场数据查询
• /api/v1/fundamental/*
  • 基本面与估值
• /api/v1/money-flow/*
  • 资金流分析
• /api/v1/news/*
  • 统一新闻检索与个股新闻搜索
• /api/v1/filings/*
  • SEC / A 股公告与文档处理
• /api/v1/code-export/*
  • 面向代码执行工作流的数据导出
• /health
  • 健康检查
• /docs / /redoc
  • OpenAPI 文档

也就是说，这个项目不是只有 MCP。

如果你不打算接 MCP 客户端，完全可以只把它当普通 HTTP 服务来用。

MCP 能做什么

MCP 侧会把这些能力暴露成 tools，主要对应：

• 行情和资产查询
• 技术分析
• 基本面与行业研究
• 新闻与事件
  • 当前统一走 Tavily 检索，不再保留 adapter 原生新闻分支
• 资金流与筹码
• 公告与文档处理

MCP 入口：

• POST /mcp

适用场景：

• Claude Desktop
• Cursor
• DeerFlow
• 其他支持 MCP 的 Agent 平台

大体架构

                +-----------------------------+
                |    MCP Clients / HTTP Apps  |
                | Claude / Cursor / Backends  |
                +--------------+--------------+
                               |
                               v
                    +-----------------------+
                    |   Thin Transports     |
                    |  HTTP / MCP / Docs    |
                    +-----------+-----------+
                                |
                                v
                    +-----------------------+
                    |        Runtime        |
                    | auth / proxy / health |
                    | lifecycle / registry  |
                    +-----------+-----------+
                                |
                +---------------+----------------+