Tushare MCP
A股数据查询服务，基于 MCP (Model Context Protocol) 协议，支持通过 AI 助手（Claude Desktop、Cursor 等）用自然语言查询股票数据。
重要说明
本项目使用 tinyshare SDK，而非官方 tushare。
如果你想用官方 tushare，修改 server.py 第 5 行：
# 当前
import tinyshare as ts
# 改为
import tushare as ts
同时修改 requirements.txt：将 tinyshare 替换为 tushare==版本号
功能
提供 25 个 MCP 工具，覆盖：
- A股、港股基本信息
- 日线行情、财务报表
- 股东信息、指数数据
- 龙虎榜、交易日历
快速开始
安装
# 1. 克隆项目
git clone <你的仓库地址>
cd tushare-mcp
# 2. 创建虚拟环境（macOS 必需）
python3 -m venv venv
source venv/bin/activate
# 3. 安装依赖
pip install -r requirements.txt
配置 Token
启动后，在 AI 助手中调用 setup_tushare_token 工具配置。
或手动创建配置文件：
mkdir -p ~/.tushare_mcp
echo "TUSHARE_TOKEN=你的token" > ~/.tushare_mcp/.env
启动服务
python server.py
服务运行在 http://localhost:8000
- 健康检查:
http://localhost:8000/ - API 文档:
http://localhost:8000/docs - MCP 端点:
http://localhost:8000/sse
使用
Claude Desktop
编辑配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"tushare": {
"url": "http://localhost:8000/sse"
}
}
}
重启 Claude Desktop 即可使用。
Cursor
设置 → MCP Servers → 添加：
- 名称:
tushare - URL:
http://localhost:8000/sse
HTTP API
# 配置 Token
curl -X POST http://localhost:8000/tools/setup_tushare_token \
-H "Content-Type: application/json" \
-d '{"token": "你的token"}'
工具列表
Token 管理
setup_tushare_token- 配置 Tokencheck_token_status- 检查 Token 状态
股票信息
get_stock_basic_info- A股基本信息get_hk_stock_basic- 港股基本信息search_stocks- 搜索股票
行情数据
get_daily_prices- 日线行情（开高低收）get_daily_metrics- 换手率、PE/PBget_daily_basic_info- 股本、市值get_period_price_change- 区间涨跌幅
财务数据
get_financial_indicator- 财务指标get_income_statement- 利润表get_balance_sheet- 资产负债表get_cash_flow- 现金流量表get_fina_mainbz- 主营业务构成
股东信息
get_shareholder_count- 股东户数get_top_holders- 前十大股东
指数数据
search_index- 搜索指数get_index_list- 指数列表get_index_constituents- 指数成分股get_global_index_quotes- 国际指数行情
特色数据
get_pledge_detail- 股权质押get_top_list_detail- 龙虎榜get_top_institution_detail- 龙虎榜机构席位
工具
get_trade_calendar- 交易日历get_start_date_for_n_days- 计算往前N个交易日
数据格式
日期: YYYYMMDD（如 20240930）
股票代码:
- A股:
000001.SZ(深圳) /600000.SH(上海) - 港股:
00700.HK - 指数:
000300.SH
金额单位:
- 财务数据: 亿元
- 股本: 万股
- 市值: 万元
Docker 部署
docker build -t tushare-mcp .
docker run -d -p 8000:8000 -e TUSHARE_TOKEN=你的token tushare-mcp
故障排查
Token 无效
# 测试 Token（使用 tinyshare）
python3 << EOF
import tinyshare as ts
ts.set_token('你的token')
print(ts.pro_api().stock_basic(ts_code='000001.SZ'))
EOF
服务无法访问
# 检查服务状态
ps aux | grep server.py
# 检查端口占用
lsof -i :8000
MCP 连接失败
# 测试端点
curl http://localhost:8000/
curl http://localhost:8000/sse
License
MIT