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 規範。
• 開源社區提供了優秀的工具和庫。

祝您交易愉快！🚀