Tushare MCP Server

🚀 Tushare MCP 服务器

Tushare MCP 服务器是一个基于模型上下文协议（MCP）的服务器，它借助 Tushare API 为 AI 助手提供访问中国股票市场数据的能力，助力用户更高效地获取和分析股票信息。

🚀 快速开始

安装

选项 1：从源代码安装

git clone <repository-url>
cd tushare-mcp-server
pip install -r requirements.txt
pip install -e .

选项 2：直接执行 Python 代码

# 克隆仓库并直接运行，无需安装
git clone <repository-url>
cd tushare-mcp-server
pip install -r requirements.txt

配置

1. 获取 Tushare 令牌：从 Tushare Pro 获取你的 Tushare 令牌。

2. 设置环境变量：

   export TUSHARE_TOKEN="your_tushare_api_token_here"
   

3. 或者创建 .env 文件：

   cp .env.example .env
   # 编辑 .env 文件，添加你的 TUSHARE_TOKEN
   

基本用法

命令行方式

# 启动 MCP 服务器
TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

# 开启调试模式
DEBUG=true TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

与 Claude Desktop 集成

在你的 Claude Desktop 设置中添加以下配置：

{
  "mcpServers": {
    "tushare": {
      "command": "python",
      "args": ["-m", "tushare_mcp_server.main"],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_api_token_here"
      }
    }
  }
}

✨ 主要特性

• 核心市场数据 API：提供基本的股票信息和价格数据。
• 日、周、月价格数据：提供历史股票价格数据。
• 全面支持 MCP 协议：可与 Claude Desktop 等 MCP 客户端配合使用。
• 专业的错误处理：具备强大的 API 错误管理能力。
• 类型安全：所有参数均通过 Pydantic 进行全面验证。

💻 使用示例

基础用法

示例 1：获取基本股票信息

用户查询："Tell me about Ping An Bank (000001.SZ)" Claude 将使用：stock_basic 工具 参数：

{
  "ts_code": "000001.SZ"
}

返回结果：公司名称、地区、行业、上市日期等。

示例 2：获取每日股票价格

用户查询："Show me the daily prices for 000001.SZ for January 2024" Claude 将使用：daily 工具 参数：

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20240131"
}

返回结果：每个交易日的开盘价、最高价、最低价、收盘价、成交量、成交额。

示例 3：获取每周股票数据

用户查询："Show me weekly data for 000001.SZ" Claude 将使用：weekly 工具 参数：

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20240131"
}

返回结果：每周的开盘价、最高价、最低价、收盘价和成交量。

示例 4：获取每月股票数据

用户查询："Show me monthly data for 000001.SZ" Claude 将使用：monthly 工具 参数：

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20241231"
}

返回结果：每月的开盘价、最高价、最低价、收盘价和成交量。

🔧 可用工具

股票基本信息

• stock_basic：获取基本的股票和公司信息。

市场数据

• daily：获取每日股票价格（开盘价、最高价、最低价、收盘价、成交量、成交额）。
• weekly：获取每周股票数据（需要 2000+ Tushare 积分）。
• monthly：获取每月股票数据（需要 2000+ Tushare 积分）。

📊 股票代码格式

股票代码应包含交易所后缀：

• .SZ：深圳证券交易所（例如：000001.SZ）
• .SH：上海证券交易所（例如：600000.SH）
• .BJ：北京证券交易所（例如：830799.BJ）

📅 日期格式

所有日期均使用 YYYYMMDD 格式：

• 20240101：2024 年 1 月 1 日
• 20231231：2023 年 12 月 31 日

⚙️ 配置选项

环境变量

• TUSHARE_TOKEN：你的 Tushare API 令牌（必需）
• DEBUG：启用调试日志（可选，默认值：false）
• HOST：服务器主机（可选，默认值：0.0.0.0）
• PORT：服务器端口（可选，默认值：8000）

.env 文件示例

TUSHARE_TOKEN=your_token_here
DEBUG=false
HOST=0.0.0.0
PORT=8000

🧪 测试

基本功能测试

# 测试包导入
python -c "from tushare_mcp_server.main import main; print('✅ Package loads correctly')"

# 运行演示
python demo_simple.py

# 启动服务器
TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

📚 详细文档

已实现的端点的 API 文档位于 api/ 目录下：

• 身份验证与使用 (api/authentication-usage.md)
• 股票基本信息 (api/stock_basic.md)
• 市场数据 (api/data_daily.md, api/data_weekly.md, api/data_monthly.md)

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• Tushare Pro 提供金融数据 API。
• Model Context Protocol 提供 MCP 规范。
• 开源社区提供了优秀的工具和库。

祝您交易愉快！🚀