MCP Servers

A collection of Model Context Protocol servers, templates, tools and more.

T
Tushare MCP Http
by @duhanjun
GitHub Repo(1 stars)

基于Tushare Pro的 MCP 服务器，提供 HTTP 传输协议支持，让 AI 助手能够通过 MCP 协议获取金融数据。

Created 3/16/2026
Updated about 3 hours ago
README
View Source
Repository documentation and setup instructions

tushare-mcp-http

基于 Tushare Pro 的 MCP 服务器，提供 HTTP 传输协议支持，让 AI 助手能够通过 MCP 协议获取金融数据。

项目简介

tushare-mcp-http 是一个基于 FastMCP 框架开发的 MCP（Model Context Protocol）服务器，通过 HTTP 协议为 AI 助手提供 Tushare 金融数据接口。该项目支持多种金融数据的查询，包括 A 股、指数、基金、期货、债券、港股、美股以及宏观经济数据等。

特性

  • 🚀 HTTP 传输协议 - 支持 streamable-http 传输，适合远程部署
  • 🔐 API Key 认证 - 支持 Bearer Token 认证，保护 API 安全
  • 📊 丰富的数据类型 - 覆盖股票、指数、基金、期货、债券、港股、美股、宏观经济等
  • 🔧 模块化设计 - 清晰的代码结构，按数据类型分离模块
  • 🛠️ 通用查询接口 - 通过 tushare_query 工具可调用任意 Tushare API
  • 📚 完整的接口文档 - 内置 API 列表和文档查询工具

项目结构

tushare-mcp-http/
├── tushare_mcp_http/           # 主包目录
│   ├── __init__.py            # 包初始化文件
│   ├── __main__.py            # 命令行入口
│   ├── server.py              # 服务器主模块
│   ├── auth.py                # 认证中间件模块
│   ├── config.py              # 配置管理模块
│   ├── py.typed               # 类型提示标记文件
│   └── tools/                 # 工具模块目录
│       ├── __init__.py        # 工具模块初始化
│       ├── base.py            # 基础工具（格式化函数）
│       ├── common.py          # 通用工具
│       ├── stock.py           # 股票工具
│       ├── index.py           # 指数工具
│       ├── fund.py            # 基金工具
│       ├── futures.py         # 期货工具
│       ├── bond.py            # 债券工具
│       ├── hk_stock.py        # 港股工具
│       ├── us_stock.py        # 美股工具
│       └── macro.py           # 宏观经济工具
├── pyproject.toml             # 项目配置文件
├── requirements.txt           # 依赖列表
└── README.md                  # 项目文档

安装

通过 pip 安装

pip install tushare-mcp-http

从源码安装

git clone https://github.com/yourusername/tushare-mcp-http.git
cd tushare-mcp-http
pip install -e .

配置

1. 获取 Tushare Token

到 Tushare 官网 注册账号并获取 API token。

2. 配置环境变量

# Linux/macOS
export TUSHARE_TOKEN="your_token_here"

# Windows PowerShell
$env:TUSHARE_TOKEN = "your_token_here"

# Windows CMD
set TUSHARE_TOKEN=your_token_here

3. 认证配置（可选）

服务器默认启用 API Key 认证，启动时会自动生成一个随机 API Key。

# 自定义 API Key（推荐）
export MCP_API_KEY="your_secure_api_key_here"

# Windows PowerShell
$env:MCP_API_KEY = "your_api_key_here"

# Windows CMD
set MCP_API_KEY=your_api_key_here

# 禁用认证（不推荐，仅限内网测试）
export MCP_AUTH_ENABLED=false

# Windows PowerShell
$env:MCP_AUTH_ENABLED = "false"

# Windows CMD
set MCP_AUTH_ENABLED=false

4. 其他可选配置

export MCP_HOST=0.0.0.0      # 服务地址，默认 0.0.0.0
export MCP_PORT=8000          # 服务端口，默认 8000
export MCP_PATH=/mcp          # 服务路径，默认 /mcp

使用方法

启动服务器

tushare-mcp-http

启动后会显示：

正在启动 tushare-mcp-http...
Tushare Token: your_toke***
服务器地址: http://0.0.0.0:8000/mcp
认证: 已启用
API Key: xxxxxxxx...xxxx

⚠️ 重要：请妥善保管启动时显示的 API Key，客户端连接时需要使用。

MCP 客户端配置

将以下配置添加到您的 MCP 客户端：

带认证的配置（推荐）：

{
  "mcpServers": {
    "tushare": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key_here"
      }
    }
  }
}

无认证的配置（需设置 MCP_AUTH_ENABLED=false）：

{
  "mcpServers": {
    "tushare": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

可用工具

通用工具

| 工具名 | 描述 | | ----------------- | ------------------- | | tushare_query | 通用 Tushare API 查询接口 | | get_api_list | 获取支持的 API 接口列表 | | get_api_doc | 获取指定 API 的文档说明 | | test_connection | 测试 Tushare API 连接状态 |

股票工具

| 工具名 | 描述 | | ------------------------- | ----------------- | | get_stock_list | 获取股票基础列表 | | get_trade_calendar | 获取交易日历 | | get_daily_quote | 获取日线行情数据 | | get_weekly_quote | 获取周线行情数据 | | get_monthly_quote | 获取月线行情数据 | | get_daily_basic | 获取每日指标（PE、PB、市值等） | | get_adj_factor | 获取复权因子 | | get_suspend_info | 获取停复牌信息 | | get_income_statement | 获取利润表数据 | | get_balance_sheet | 获取资产负债表数据 | | get_cashflow_statement | 获取现金流量表数据 | | get_financial_indicator | 获取财务指标数据 | | get_forecast | 获取业绩预告数据 | | get_express | 获取业绩快报数据 | | get_dividend | 获取分红送股数据 | | get_top10_holders | 获取前十大股东数据 | | get_top10_floatholders | 获取前十大流通股东数据 | | get_share_number | 获取股东人数数据 | | get_margin_detail | 获取融资融券交易明细 |

指数工具

| 工具名 | 描述 | | ---------------------- | --------- | | get_index_basic | 获取指数基础信息 | | get_index_daily | 获取指数日线行情 | | get_index_weekly | 获取指数周线行情 | | get_index_monthly | 获取指数月线行情 | | get_index_weight | 获取指数成分股权重 | | get_index_dailybasic | 获取指数每日指标 | | get_index_classify | 获取指数分类 |

基金工具

| 工具名 | 描述 | | -------------------- | ---------- | | get_fund_basic | 获取基金基础信息 | | get_fund_nav | 获取基金净值数据 | | get_fund_daily | 获取场内基金日线行情 | | get_fund_adj | 获取基金复权数据 | | get_fund_div | 获取基金分红数据 | | get_fund_portfolio | 获取基金持仓数据 | | get_fund_manager | 获取基金经理信息 | | get_fund_company | 获取基金公司信息 | | get_fund_share | 获取基金份额数据 |

期货工具

| 工具名 | 描述 | | --------------------- | ----------- | | get_fut_basic | 获取期货合约基础信息 | | get_fut_daily | 获取期货日线行情 | | get_fut_mins | 获取期货分钟行情 | | get_fut_holding | 获取期货持仓数据 | | get_fut_settle | 获取期货结算参数 | | get_fut_mapping | 获取主力与连续合约映射 | | get_fut_wsr | 获取仓单日报数据 | | get_index_fut_daily | 获取股指期货日线行情 |

债券工具

| 工具名 | 描述 | | ------------------ | --------- | | get_cb_basic | 获取可转债基础信息 | | get_cb_daily | 获取可转债日线行情 | | get_cb_issue | 获取可转债发行信息 | | get_cb_price_chg | 获取可转债价格变动 | | get_cb_share | 获取可转债转股数据 | | get_bond_basic | 获取债券基础信息 | | get_bond_daily | 获取债券日线行情 |

港股工具

| 工具名 | 描述 | | --------------------- | --------- | | get_hk_basic | 获取港股基础信息 | | get_hk_daily | 获取港股日线行情 | | get_hk_hold | 获取港股通持股数据 | | get_hk_income | 获取港股利润表 | | get_hk_balancesheet | 获取港股资产负债表 | | get_hk_cashflow | 获取港股现金流量表 |

美股工具

| 工具名 | 描述 | | --------------------- | --------- | | get_us_basic | 获取美股基础信息 | | get_us_daily | 获取美股日线行情 | | get_us_adj | 获取美股复权因子 | | get_us_income | 获取美股利润表 | | get_us_balancesheet | 获取美股资产负债表 | | get_us_cashflow | 获取美股现金流量表 |

宏观工具

| 工具名 | 描述 | | ------------------ | -------------------- | | get_cn_cpi | 获取中国 CPI 居民消费价格指数 | | get_cn_ppi | 获取中国 PPI 工业生产者出厂价格指数 | | get_cn_gdp | 获取中国 GDP 国内生产总值 | | get_cn_pmi | 获取中国 PMI 采购经理指数 | | get_cn_m | 获取中国货币供应量 | | get_shibor | 获取上海银行间同业拆放利率 | | get_shibor_quote | 获取 Shibor 报价数据 | | get_lpr | 获取贷款市场报价利率 | | get_libor | 获取伦敦银行间同业拆借利率 | | get_hibor | 获取香港银行间同业拆借利率 |

交互示例

安装并配置后，您可以通过 MCP 客户端用自然语言与 AI 助手交互：

获取股票数据：

获取平安银行最近 30 天的股价数据

财务分析：

查看招商银行最近的财务报表，分析营收和净利润

指数数据：

获取上证指数最近的行情数据

宏观数据：

查询最近一年的 GDP 和 CPI 数据

通用查询：

使用 tushare_query 查询龙虎榜数据

参数格式说明

  • 日期格式：YYYYMMDD（如 20241231）
  • 股票代码：ts_code 格式（如 000001.SZ, 600000.SH）
  • 返回格式：JSON 格式，包含 success、data、count、columns 字段

开发指南

本地开发

# 克隆项目
git clone https://github.com/yourusername/tushare-mcp-http.git
cd tushare-mcp-http

# 安装开发依赖
pip install -e ".[dev]"

# 运行服务
python -m tushare_mcp_http.server

打包发布

# 安装打包工具
pip install build twine

# 打包
python -m build

# 上传到 PyPI
twine upload dist/*

环境变量

| 变量名 | 描述 | 默认值 | | ------------------ | ------------------- | ------------------ | | TUSHARE_TOKEN | Tushare API token | 必填 | | MCP_HOST | 服务器监听地址 | 0.0.0.0 | | MCP_PORT | 服务器监听端口 | 8000 | | MCP_PATH | MCP 服务路径 | /mcp | | MCP_NAME | 服务名称 | tushare-mcp-http | | MCP_API_KEY | API 认证密钥 | 自动生成 32 位随机密钥 | | MCP_AUTH_ENABLED | 是否启用认证（true/false） | true |

相关链接

许可证

MIT License

注意事项

  • 本项目仅供学习和研究使用
  • 使用时请遵守 Tushare 使用条款
  • API 调用有频率限制，请合理使用
  • 数据来源于 Tushare，请勿用于商业用途
Quick Setup
Installation guide for this server

Install Package (if required)

uvx tushare-mcp-http

Cursor configuration (mcp.json)

{ "mcpServers": { "duhanjun-tushare-mcp-http": { "command": "uvx", "args": [ "tushare-mcp-http" ] } } }