영어 | 中文

开源金融数据 MCP / HTTP 서비스,面向 AI Agent, 量化脚本和普通后端集成.

中文

这是什么

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

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

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

• 稳定的数据源接入
• 标准化的金融工具能力
• 适合 Agent 使用的 MCP 도구 / 아티팩트 输出
• 适合代码执行工作流的 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 / 에드가 제출 서류
• A 股公告处理
• 문서 청크 / 마크다운 / 구조화 추출

5. Agent / Code Workflow 友好能力

• MCP 도구 통합 등록
• 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  |
                    +-----------+-----------+
                                |
                +---------------+----------------+