TushareBLOCK

基于 MCP (Model Context Protocol) 的 Tushare 金融数据服务器,提供 52 个专业金融数据分析工具。

🎯 项目特性

• ✅ 52个专业工具 - 涵盖股票、期货、外汇、财务等10大类
• ✅ 双模式支持 - stdio 模式和 HTTP SSE 模式
• ✅ 智能缓存 - 自动缓存管理,提升查询效率
• ✅ 权限管理 - 支持不同 Tushare 权限级别
• ✅ 开箱即用 - 自动工具发现和注册

📦 快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置 Tushare Token

在项目根目录创建 .env 文件:

TUSHARE_TOKEN=your_token_here

获取 Token: https://tushare.pro/user/token

3. 选择运行模式

方式 A: stdio 模式(推荐用于 Claude Desktop)

配置文件: %APPDATA%\Claude\claude_desktop_config.json (Windows) 或 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
"mcpServers": {
"tushare": {
"command": "python",
"args": ["D:/AI/tushare_MCP/server.py"]
}
}
}

启动: 重启 Claude Desktop 即可自动启动

方式 B: Streamable HTTP 模式(推荐用于调试和远程访问)

启动服务器:

# Windows
start_http_server.bat

# Linux/macOS
chmod +x start_http_server.sh
./start_http_server.sh

配置文件: 同上 Claude Desktop 配置文件

{
"mcpServers": {
"tushare-http": {
"url": "http://127.0.0.1:8000/mcp"
}
}
}

🛠️ 模式对比

📊 工具分类

Tushare MCP 工具完整列表 本文档列出了所有支持的MCP工具,共 52个工具,分为10个类别。

📊 一、Alpha策略分析工具 (6个) 行业Alpha分析 analyzesectoralpha_strategy

功能:分析单个板块相对强度Alpha,计算2日和5日Alpha收益 参数:sectorcode(板块代码,必填)、benchmarkcode(基准指数,默认000300.SH)、enddate(结束日期,YYYYMMDD格式,默认今天) 说明:计算2天和5天的区间收益率,计算超额收益Alpha = 板块收益 - 基准收益,综合得分 = Alpha2 × 60% + Alpha5 × 40% ranksectorsbyalpha

功能:申万一级行业Alpha排名,显示前N名强势板块 参数:benchmarkcode(基准指数,默认000300.SH)、enddate(结束日期,YYYYMMDD格式,默认今天)、topn(显示前N名,默认10) 说明:自动分析所有31个申万一级行业,按综合得分降序排列 rankl2sectorsby