FTShare MCP

中文 | English

FTShare MCP 是面向 AI Agent 的金融数据 MCP 服务，让 Claude Code、Codex、WorkBuddy、OpenClaw、Hermes 等支持 MCP 的客户端，可以通过自然语言调用 FTShare 的行情、财务、宏观、基金、期货、债券、美股和港股数据。

本仓库提供 MCP 工具文档、参数说明和接入示例，不包含 MCP Server 源码。公共 MCP 服务由 FTShare 数据服务提供。

当前服务

• 服务版本：FTShare MCP Server 0.1.1
• 公共地址：https://market.ft.tech/gateway/mcp
• 传输协议：MCP Streamable HTTP
• 工具数量：171
• 工具构成：164 个 ft_* 数据工具 + 7 个便捷查询入口
• 服务属性：只读金融数据服务
• 实时工具定义：以 MCP tools/list 返回结果为准

各工具文档中的 <MCP_BASE_URL> 均应替换为公共地址。首次直接调用协议时，先通过 initialize 获取 Mcp-Session-Id，后续请求再携带该会话 ID 调用 tools/list 或 tools/call。

数据能力

• A 股行情、K 线、涨跌停、资金流、龙虎榜、股东和财务数据
• ETF、指数、基金净值、基金持仓、基金经理和基金公司
• 港股、美股、期货、债券和贵金属
• 宏观经济、财经日历、公告、研报和财经新闻
• 语义新闻检索及面向 Agent 的便捷查询入口

FTShare 生态中的位置

FTShare 是底层金融数据服务，SDK、MCP 和 Skill 是不同的使用方式：

FTShare 数据服务
    ├── FTShare Python SDK   开发者编程调用
    ├── FTShare MCP          Agent 标准化数据调用
    └── FTShare Skills       投研任务与业务工作流

MCP 负责让 Agent 获取数据，Skill 负责告诉 Agent 如何完成一项投研任务。

快速接入

Claude Code

claude mcp add --transport http --scope user ftshare https://market.ft.tech/gateway/mcp

进入 Claude Code 后输入 /mcp，确认列表中存在 ftshare。

Codex

在 ~/.codex/config.toml 中加入：

[mcp_servers.ftshare]
url = "https://market.ft.tech/gateway/mcp"

保存后执行 codex mcp get ftshare 检查配置。

WorkBuddy

在 ~/.workbuddy/mcp.json 中加入：

{
  "mcpServers": {
    "ftshare": {
      "type": "streamableHttp",
      "url": "https://market.ft.tech/gateway/mcp",
      "timeout": 30000,
      "disabled": false
    }
  }
}

其他支持 Streamable HTTP MCP 的客户端，也可以使用同一个公共地址接入。

协议调用说明

• 直接调用协议时，先发送 initialize 获取 Mcp-Session-Id。
• 初始化后发送 notifications/initialized，后续请求同时携带 Session ID 和协商后的 MCP-Protocol-Version。
• tools/list 返回每个工具的 title、inputSchema、outputSchema、只读 annotations 和 _meta.securitySchemes。
• 调用成功时优先读取 result.structuredContent；result.content[0].text 是同值的序列化 JSON。
• 参数校验、上游服务及业务执行错误位于 result 中，并设置 isError=true。

使用示例

配置完成后，可以直接向 Agent 提问：

• 使用 FTShare 查询贵州茅台最近 5 个交易日的日 K 线
• 查询今天 A 股涨停和跌停数量
• 查询沪深 300 对应的 ETF
• 查询某只基金的净值、持仓和基金经理
• 搜索最近与机器人概念相关的财经新闻

返回结构

从 0.1.1 开始，所有工具统一返回结构化 JSON。成功结果同时提供 structuredContent，以及 content[0].text 中的同值 JSON 文本：

{
  "metadata": {
    "schema_version": "1.0",
    "source": "ftshare",
    "tool": "ft_get_fund_list",
    "operation": "get_fund_list",
    "total": 1,
    "pagination": {
      "supported": true,
      "page": 1,
      "page_size": 1,
      "pages": 1,
      "has_more": false
    },
    "returned": 1,
    "truncated": false,
    "warnings": []
  },
  "data": []
}

Agent 和应用程序应优先读取 structuredContent.data；分页、截断和告警信息位于 structuredContent.metadata。

错误处理

参数或业务错误通过 isError=true 返回，content[0].text 中包含可机器解析的错误对象：

{
  "error": {
    "code": "INVALID_ARGUMENT",
    "field": "page_size",
    "message": "参数值不满足约束",
    "retryable": false
  }
}

调用工具时应严格遵守 tools/list 返回的 inputSchema。成功时优先读取 structuredContent，失败时先判断 isError，再解析错误对象中的 code 和 retryable。

0.1.1 更新

• 当前公开工具索引调整为 171
• 移除 echo、aggregate_demo 两个示例工具
• 新增 15 个公募基金工具
• 所有工具统一提供 title、inputSchema、outputSchema 和只读 annotations
• 所有成功结果统一提供 structuredContent
• 未声明参数、缺少必填参数和超限参数在调用前被拒绝
• 业务错误统一返回 isError=true 和结构化错误码

社区交流

欢迎加入 FTShare 社区交流群，一起讨论 MCP 接入、工具调用、金融数据接口、Agent 投研工作流和项目贡献方向。

群规说明：

• 仅限 FTShare 项目、MCP 接入、金融数据接口和 Agent 投研工作流相关讨论
• 禁止广告、推广、无关闲聊
• Bug、功能需求和工具文档问题，建议优先在 GitHub Issues 中提交，群内用于快速交流和补充说明

二维码有效期至 2026 年 7 月 29 日。 如二维码失效，请在 Issues 中留言，维护者会更新入群方式。

相关项目

• FTShare-python-sdk：FTShare 金融数据 Python SDK，面向开发者编程调用
• FTShare-skills：FTShare Agent Skill 仓库，面向数据级 Skill 和投研业务 Skill

按数据目录

工具索引

License

本项目文档采用 MIT License，详见 LICENSE。

MIT License 适用于本仓库中的文档与示例，不代表 FTShare 数据服务本身无限制开放。FTShare 数据接口的访问额度、权限和商业用途，以 FTShare 数据服务条款为准。