金融数据 MCP 服务器 (Stock Data MCP Server)
这是一个基于 Model Context Protocol (MCP) 的金融数据查询服务器，支持股票、指数、基金和期货的历史数据查询。
功能特性
- 功能模块：
- 个股深度：
- 信息 (Info)：获取个股详细信息。
- 指标 (Indicators)：获取关键财务指标（A股/港股/美股）。
- 建议 (Suggest)：基于技术指标（MA, RSI）的简单投资建议。
- 市场概况：
- 涨停/龙虎榜：获取每日涨停股池及龙虎榜数据。
- 资金流向：行业板块资金流向排名。
- 财经资讯：
- 个股新闻：获取特定股票的新闻。
- 全球快讯：获取全球财经快讯（财联社）。
- 数据查询：
- 股票 (Stock)：支持 A 股、港股、美股的历史数据查询（支持模糊搜索）。
- 指数 (Index)：支持常见指数（如 "上证指数"）。
- 基金 (Fund)：支持 ETF 和部分基金查询。
- 期货 (Futures)：支持国内及外盘期货数据。
- 个股深度：
- 数据源：
- 首选：东方财富 (Eastmoney) - 数据最全，但对云环境 IP 限制严格。
- 备用：新浪财经 (Sina) - 当首选接口连接失败时自动切换，确保服务高可用。
- 双模式运行：
- Stdio 模式：适用于本地 CLI 或 MCP Inspector。
- SSE 模式：适用于 Docker 部署或远程调用。
可用工具 (Available Tools)
- get_current_time: 获取系统时间。
- get_stock_info: 获取个股基本信息 (支持 A/港/美股)。
- get_stock_indicators: 获取个股财务指标 (PE/PB/ROE等)。
- get_financial_report: 获取个股详细财务报表摘要。
- get_trading_suggest: 获取个股简单交易建议。
- get_stock_zt_pool: 获取涨停股池。
- get_stock_lhb: 获取龙虎榜数据。
- get_sector_fund_flow: 获取行业资金流向。
- get_stock_news: 获取个股新闻。
- get_global_news: 获取全球财经快讯。
- query_stock_data: 查询 A 股历史数据 (名称/代码)。
- query_index_data: 查询 A 股指数历史数据。
- query_fund_data: 查询 A 股基金/ETF 历史数据。
- query_futures_data: 查询国内期货历史数据。
- query_us_stock_data: 查询美股历史数据 (名称/代码)。
- query_us_fund_data: 查询美股基金/ETF 历史数据。
- query_foreign_futures_data: 查询外盘期货历史数据。
- get_hk_stock_data: 查询港股历史数据。
安装与使用
1. 本地运行 (Python)
确保已安装 Python 3.10+。
# 安装依赖
pip install mcp akshare pandas starlette uvicorn httpx
# 运行 (默认 Stdio 模式)
python server.py
# 或者使用 MCP Inspector 测试
npx @modelcontextprotocol/inspector python server.py
如果你安装了 Node.js，也可以直接通过 npx 运行（需要本地有 Python 环境）：
# 在项目根目录下
npm install
npx stockdata-mcp
Cherry Studio 配置指南
本服务器完全支持 Stdio 模式，可以直接在 Cherry Studio 中配置使用。
配置步骤
- 打开 Cherry Studio。
- 进入 设置 (Settings) -> MCP 服务器 (MCP Servers)。
- 点击 添加 (Add)。
- 填写以下信息：
- 名称 (Name): Stock Data MCP (或任意名称)
- 类型 (Type): Stdio
- 命令 (Command):
python(确保 python 在系统 PATH 中，或者使用绝对路径) - 参数 (Args):
g:\path\to\stockdata\server.py(请使用 server.py 的绝对路径)
- 点击 保存 (Save)。
- 启用该服务器，Cherry Studio 应显示 "Connected" (已连接)。
常见问题
- 如果连接失败，请检查
python是否能成功运行import akshare。 - 确保 Cherry Studio 有权限访问该目录。
配置文件示例 (Claude Desktop / Cherry Studio)
你可以将以下配置添加到你的 MCP 客户端配置文件中 (如 claude_desktop_config.json)。
{
"mcpServers": {
"stockdata": {
"command": "python",
"args": [
"g:\\your-disk-path\\stockdata\\server.py"
],
"env": {
"MCP_MODE": "stdio"
}
}
}
}
注意事项
- 数据来源于
akshare，请确保网络通畅以便连接相关数据接口。 - 模糊搜索可能需要一定时间下载列表，首次运行可能会稍慢。