MCP Server for Chinese Stock Market Sector Analysis - Supports TongHuaShun (THS) and DongCai (DC) sector data via Tushare API
npm install financemcp-dcthsget_ths_index)
get_ths_daily)
get_ths_member)
get_dc_index)
get_dc_member)
get_dc_daily)
npx -y financemcp-dcths | node build/httpServer.js |
bash
npx -y financemcp-dcths
`
$3
`bash
克隆仓库
git clone https://github.com/guangxiangdebizi/FinanceMCP-DCTHS.git
cd FinanceMCP-DCTHS
安装依赖
npm install
`
$3
1. 复制环境变量模板:
`bash
cp .env.example .env
`
2. 编辑 .env 文件,填入你的 Tushare Token:
`env
TUSHARE_TOKEN=你的tushare_token
`
> 获取 Token:访问 Tushare 官网 注册并获取免费 Token
$3
`bash
npm run build
`
$3
#### stdio 模式(推荐本地使用)⭐
`bash
npm run start:stdio
`
或通过 npx 直接运行:
`bash
npx -y financemcp-dcths
`
#### HTTP 模式(服务器部署)
`bash
npm run start:http
`
服务器将在 http://localhost:3000 启动
📱 客户端配置
$3
在 Claude Desktop 配置文件中添加:
位置:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
配置内容:
`json
{
"mcpServers": {
"financemcp-dcths": {
"command": "npx",
"args": ["-y", "financemcp-dcths"],
"env": {
"TUSHARE_TOKEN": "你的tushare_token"
}
}
}
}
`
$3
`json
{
"mcpServers": {
"financemcp-dcths": {
"type": "streamableHttp",
"url": "http://localhost:3000/mcp",
"timeout": 600,
"headers": {
"X-Tushare-Token": "你的tushare_token"
}
}
}
}
`
HTTP 模式支持三种 Token 传递方式:
1. ✅ X-Tushare-Token 请求头(推荐)
2. ✅ X-Api-Key 请求头
3. ✅ Authorization: Bearer 请求头
💡 使用示例
$3
在 Claude 中输入:
`
查询所有同花顺概念指数
`
对应的 MCP 调用:
`json
{
"name": "get_ths_index",
"arguments": {
"type": "N"
}
}
`
$3
在 Claude 中输入:
`
查询东财人形机器人板块今天的数据
`
对应的 MCP 调用:
`json
{
"name": "get_dc_index",
"arguments": {
"name": "人形机器人",
"trade_date": "20231201"
}
}
`
$3
在 Claude 中输入:
`
查询同花顺人工智能板块最近一周的行情
`
对应的 MCP 调用:
`json
{
"name": "get_ths_daily",
"arguments": {
"ts_code": "885823.TI",
"start_date": "20231201",
"end_date": "20231207"
}
}
`
$3
在 Claude 中输入:
`
查询东财新能源汽车板块包含哪些股票
`
对应的 MCP 调用:
`json
{
"name": "get_dc_member",
"arguments": {
"ts_code": "BK0001.DC",
"trade_date": "20231201"
}
}
`
📚 API 参数说明
$3
#### get_ths_index - 板块指数列表
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 指数代码(如 885823.TI) |
| exchange | string | ❌ | 市场类型:A-A股 HK-港股 US-美股 |
| type | string | ❌ | 指数类型:N-概念指数 I-行业指数 R-地域指数 等 |
#### get_ths_daily - 板块行情
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 指数代码(如 885823.TI) |
| trade_date | string | ❌ | 交易日期(YYYYMMDD) |
| start_date | string | ❌ | 开始日期 |
| end_date | string | ❌ | 结束日期 |
#### get_ths_member - 板块成分
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 板块指数代码(查询该板块的成分股) |
| con_code | string | ❌ | 股票代码(查询该股票所属板块) |
$3
#### get_dc_index - 板块信息
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 指数代码(支持多个,逗号分隔) |
| name | string | ❌ | 板块名称(如:人形机器人) |
| trade_date | string | ❌ | 交易日期(YYYYMMDD) |
| start_date | string | ❌ | 开始日期 |
| end_date | string | ❌ | 结束日期 |
#### get_dc_member - 板块成分
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 板块指数代码 |
| con_code | string | ❌ | 成分股票代码 |
| trade_date | string | ❌ | 交易日期(支持历史查询) |
#### get_dc_daily - 板块行情
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ts_code | string | ❌ | 板块代码(格式:xxxxx.DC) |
| trade_date | string | ❌ | 交易日期(YYYYMMDD) |
| start_date | string | ❌ | 开始日期 |
| end_date | string | ❌ | 结束日期 |
| idx_type | string | ❌ | 板块类型:概念板块、行业板块、地域板块 |
🔐 Token 安全建议
- ✅ 本地开发:使用 .env 文件存储 Token(已在 .gitignore 中排除)
- ✅ 生产部署:使用系统环境变量或 Docker secrets
- ✅ 客户端配置:在客户端配置文件中传递 Token
- ❌ 避免:不要将 Token 硬编码在代码中或提交到 Git
🛠️ 开发指南
$3
`
src/
├── index.ts # stdio 模式入口
├── httpServer.ts # HTTP 模式入口
├── utils/
│ └── tushareClient.ts # Tushare API 客户端
└── tools/
├── thsIndex.ts # 同花顺板块指数列表
├── thsDaily.ts # 同花顺板块行情
├── thsMember.ts # 同花顺板块成分
├── dcIndex.ts # 东财板块信息
├── dcMember.ts # 东财板块成分
└── dcDaily.ts # 东财板块行情
`
$3
`bash
监听文件变化,自动编译
npm run watch
另开终端运行服务器
npm run dev
`
$3
1. 在 src/tools/ 目录下创建新工具文件
2. 实现工具接口(name, description, parameters, run)
3. 在 src/index.ts 和 src/httpServer.ts 中导入并注册工具
$3
所有工具均需要 5000-6000 积分的 Tushare 账号权限。具体权限要求:
- get_ths_index: 需要 6000 积分
- get_ths_daily: 需要 6000 积分
- get_ths_member: 需要 5000 积分
- get_dc_index: 需要 6000 积分
- get_dc_member: 需要 6000 积分
- get_dc_daily: 需要 6000 积分
🐛 常见问题
$3
A: 检查 Token 配置:
1. stdio 模式:检查环境变量或客户端配置的 env.TUSHARE_TOKEN
2. HTTP 模式:检查请求头 X-Tushare-Token` 或环境变量