gangtise-mcp

基于 Gangtise OpenAPI 的 MCP（Model Context Protocol）服务，让 Claude 等 AI 助手直接访问 Gangtise 投研平台数据。

Changelog

0.1.14 (2026-05-26)

• 新增 gangtise_read_response 工具：当其他工具返回 _truncated: true 时，模型可调用此工具按 offset / limit 分片读取 _saved_to 完整数据

  • 原先 _saved_to 路径只对自带文件读取能力的客户端（如 Claude Code）有效；Cherry Studio 等无内置文件读工具的客户端拿到路径也无法续读

  • 现在所有 MCP 客户端均可通过工具调用方式取回完整大响应，不再依赖宿主进程的文件系统能力

• 截断响应负载追加 _read_with: "gangtise_read_response" 字段，明确续读入口

• 安全：gangtise_read_response 仅允许读取系统临时目录下 gangtise-mcp-* 前缀的本进程产物，拒绝其他路径

0.1.9 (2026-05-22)

• 修复 security='all' 全市场日 K 在分片内被静默截断的问题（同步 CLI v0.14.1 / v0.14.2）：

  • A 股全市场每天约 5500 行，原 2 天/片 ≈ 11000 行命中默认 6000 上限 → 改 1 天/片

  • 港股全市场每天约 2770 行，原 3 天/片 ≈ 8300 行命中 6000 上限 → 改 2 天/片

  • 美股全市场每天约 5800 行，原 2 天/片 ≈ 11600 行命中 6000 上限 → 改 1 天/片

  • callKlineWithSharding 在 security='all' 路径自动注入 limit=10000（API 上限）；用户显式传的 limit 不变；单只证券查询不受影响

0.1.8 (2026-05-22)

• 同步 CLI v0.14.0：

  • 新增 gangtise_day_kline_us：美股历史日 K 线（NYSE / NASDAQ / AMEX，代码格式 AAPL.O / .N / .A），security='all' 自动按 2 天/片分片

  • 新增 gangtise_realtime：实时行情快照，单接口覆盖 A 股 / 港股 / 美股，支持代码混合或 aShares / hkStocks / usStocks 市场关键字批量

  • 更新 gangtise_day_kline / gangtise_day_kline_hk 描述，明确仅返回历史数据，盘中实时改走 gangtise_realtime

• 注意：gangtise_valuation_analysis 返回字段不再包含 p10 / p25 / p75 / p90（后端字段精简，工具入参未变）

0.1.7 (2026-05-18)

• 修复一批入参字段名与后端不一致的问题（filter 之前被静默忽略或直接报错）：

  • gangtise_minute_kline: securityList → securityCode（原报 "非有效A股"）

  • gangtise_knowledge_batch: queryList/resourceType/knowledgeName → queries/resourceTypes/knowledgeNames（原返回 null）

  • gangtise_management_discuss_*: dimension → discussionDimension（原报 "参数错误"）

  • gangtise_wechat_chatroom_list: roomName 数组 → 逗号拼接字符串（原报 "请求参数解析失败"）

  • 多个 list 工具单数 filter → 数组 *List：opinion/summary/research 的 source/category/market/rating/...；hot_topic 的 category；record/wechat_message/my_conference 的 category/tag/...；earning_forecast 的 consensus

  • research 的 minPages/maxPages → minReportPages/maxReportPages

• 修复 gangtise_valuation_analysis 的 skipNull 参数（之前声明但未生效，现客户端真实过滤）

• 同步 CLI v0.13.x 完整入参集：

  • opinion_list: +chiefList +conceptList

  • roadshow/site_visit/strategy/forum_list: 补全 researchAreaList/institutionList/securityList/categoryList/marketList/participantRoleList/brokerTypeList/objectList/permission

  • foreign_report_list: +searchType/regionList/categoryList/industryList/brokerList/llmTagList/ratingList/ratingChangeList/minReportPages/maxReportPages

  • foreign_opinion_list: +regionList/industryList/brokerList/ratingList/ratingChangeList

  • independent_opinion_list: +industryList/ratingList/ratingChangeList

  • announcement_list: +searchType/announcementTypeList

  • announcement_hk_list: +searchType/rankType/categoryList

  • drive_list: fileType/spaceType → fileTypeList/spaceTypeList（数组）

  • record_list: spaceType → spaceTypeList（数组）

  • securities_search: +category/top

0.1.6 (2026-05-16)

• 新增港股三大报表：gangtise_income_statement_hk、gangtise_balance_sheet_hk、gangtise_cash_flow_hk（中国会计准则，period 支持 q1/h1/q3/h2/nsd/annual/latest）

• 新增自选股池：gangtise_stock_pool_list、gangtise_stock_pool_stocks（不传参数默认返回所有池）

• 新增另类数据（EDB）：gangtise_edb_search、gangtise_edb_data（自动归一化 fieldList+dataList 为对象数组）

• 修复财报工具字段筛选参数：field 更正为 fieldList，影响所有利润表/资产负债表/现金流量表/估值工具（A股 + 港股）

• 更新 gangtise_management_discuss_announcement dimension 新增 all 选项

• 更新 gangtise_wechat_message_list：新增 securityList 参数，修正 tag 枚举值

• 更新 gangtise_my_conference_list category 枚举与 CLI 同步

0.1.5

• 修复群消息分页

0.1.4

• 新增大响应截断与本地文件保存（超 256 KB 时写临时文件，内联返回前 20 条预览）

0.1.3

• 工具元数据注入当前日期，避免 AI 使用训练数据年份

功能覆盖

前置要求

• Node.js ≥ 20

• Gangtise 开放平台账号（申请地址），获取 accessKey / secretKey

快速开始

Claude Code

claude mcp add gangtise \
  -e GANGTISE_ACCESS_KEY=your_access_key \
  -e GANGTISE_SECRET_KEY=your_secret_key \
  -- npx -y gangtise-mcp@latest

Claude Desktop

编辑配置文件（根据系统选择路径）：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gangtise": {
      "command": "npx",
      "args": ["-y", "gangtise-mcp@latest"],
      "env": {
        "GANGTISE_ACCESS_KEY": "your_access_key",
        "GANGTISE_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

修改后重启 Claude Desktop 生效。

Cursor

编辑 ~/.cursor/mcp.json（全局）或项目根目录下 .cursor/mcp.json：

{
  "mcpServers": {
    "gangtise": {
      "command": "npx",
      "args": ["-y", "gangtise-mcp@latest"],
      "env": {
        "GANGTISE_ACCESS_KEY": "your_access_key",
        "GANGTISE_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "gangtise": {
      "command": "npx",
      "args": ["-y", "gangtise-mcp@latest"],
      "env": {
        "GANGTISE_ACCESS_KEY": "your_access_key",
        "GANGTISE_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Cline（VS Code 插件）

打开 VS Code → Cline 插件面板 → MCP Servers → Edit MCP Settings，加入：

{
  "gangtise": {
    "command": "npx",
    "args": ["-y", "gangtise-mcp@latest"],
    "env": {
      "GANGTISE_ACCESS_KEY": "your_access_key",
      "GANGTISE_SECRET_KEY": "your_secret_key"
    }
  }
}

其他支持 MCP 的客户端

配置格式通用，只需在对应客户端的 MCP 配置文件中加入：

{
  "command": "npx",
  "args": ["-y", "gangtise-mcp@latest"],
  "env": {
    "GANGTISE_ACCESS_KEY": "your_access_key",
    "GANGTISE_SECRET_KEY": "your_secret_key"
  }
}

升级到最新版本

npx -y gangtise-mcp 不会每次都去 registry 拉最新版——npx 会把已下载的版本缓存到 ~/.npm/_npx/<hash>/ 下，后续启动直接复用。npm 发布了新版本但客户端工具列表没出现新工具时，多半就是这个原因。

任选其一：

方法 1：配置里钉版本（推荐） —— 把 args 改成 ["-y", "gangtise-mcp@latest"] 或具体版本 ["-y", "gangtise-mcp@0.x.x"]，重启 MCP 客户端即可强制拉新。

方法 2：清 npx 缓存

# macOS / Linux
rm -rf ~/.npm/_npx
# Windows (PowerShell)
Remove-Item -Recurse -Force $env:LOCALAPPDATA\npm-cache\_npx

清完缓存后，在 MCP 客户端里关掉再打开 gangtise 服务（或重启客户端），npx 会重新下载最新版。

怎么确认当前跑的是哪个版本？查 ~/.npm/_npx/*/node_modules/gangtise-mcp/package.json 的 version 字段。

环境变量

认证优先级：GANGTISE_TOKEN > Token 缓存文件 > GANGTISE_ACCESS_KEY + GANGTISE_SECRET_KEY（自动换取并缓存 Token）。

大响应处理

当单次工具调用返回超过 256 KB 时，完整数据会写入本地临时文件（/tmp/gangtise-mcp-*/response.json），MCP 响应改为内联返回前 20 条预览及元数据：

AI 可直接读取 _saved_to 路径获取完整数据。若单条内容过大导致 20 条预览本身也超过阈值，则只返回元数据，_preview_count 为 0。

开发

git clone https://github.com/gangtiser/gangtise-mcp
cd gangtise-mcp
npm install
npm run dev      # 直接运行源码（tsx，无需 build）
npm run build    # 编译 TypeScript → dist/
npm test         # 运行测试

License

MIT