Tushare MCP

A股数据查询服务，基于MCP（模型上下文协议）协议，通过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

启动后，调用 setup_tushare_token 工具进行配置。

或者手动创建配置文件：

mkdir -p ~/.tushare_mcp
echo "TUSHARE_TOKEN=你的token" > ~/.tushare_m

启动服务

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服务器 → 添加：

• 名称：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 - 配置Token
• check_token_status - 检查Token状态

股票信息

• get_stock_basic_info - A股基本信息
• get_hk_stock_basic - 港股基本信息
• search_stocks - 股票搜索

市场数据

• get_daily_prices - 日市场趋势（开盘最高收盘最低）
• get_daily_metrics - 换手率PE/PB
• get_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

货币单位：

• 财务数据：100万元
• 股本：10000股
• 市值：10000元

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

许可证

MIT