How do I install FTShare?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does FTShare need an API key?

No required environment variable is listed on this record.

What transport does FTShare use?

FTShare runs locally over stdio.

When was FTShare last checked?

Last checked 2026-10-28. FTShare financial data MCP for AI Agents｜通过标准 MCP 接入基础金融数据与 FTShare 特色因子，返回结构化、可核对的结果。

FTShare MCP server

[!IMPORTANT] 本仓库提供 MCP 工具文档、参数说明和接入示例，不包含 MCP Server 源码。公共 MCP 服务由 FTShare 托管，使用前需要配置 FTSHARE_API_KEY。

FTShare MCP 是什么

FTShare MCP 是面向 AI Agent 的只读金融数据 MCP 服务。Claude Code、Codex 及其他支持 Streamable HTTP MCP 的客户端，可以把自然语言问题转换为标准工具调用，并获得结构化、可核对的结果。 https://github.com/user-attachments/assets/5f2a8475-ff7e-421a-9349-aacf284f9cc9

60 秒接入

1. 获取 API Key

请求 FTShare MCP 时使用以下 HTTP Header：

FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY

请勿将真实 API Key 提交到 Git 仓库、Issue、日志或公开截图。

2. 配置客户端

Claude Code

claude mcp add --transport http --scope user \
  --header "FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY" \
  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"
http_headers = { FTSHARE_API_KEY = "YOUR_FTSHARE_API_KEY" }

保存后执行：

codex mcp get ftshare

配置变更后新开一个 Codex 任务，使工具定义重新加载。配置文件包含密钥，请勿公开提交。

其他 MCP 客户端

Transport：Streamable HTTP
URL：https://market.ft.tech/gateway/mcp
Header：FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY

不同客户端的字段名称可能不同，请以对应客户端的自定义 HTTP Header 文档为准。

3. 提出一个特色数据问题

使用 FTShare 查询深圳机场（000089）在 2026 年 9 月 1 日的上升旗形标注，返回图片 hash、标注图和识别理由。

返回结果

标的	快照日期	形态	状态	置信度
深圳机场（000089）	2026-09-01	上升旗形	`candidate`	0.58

标注区间：2026-08-27 13:00 至 2026-09-01 14:45。

图片 hash

a1eab19298a3d3bbda501330a03879d5984edcc1a64e8c271f529dec8e8f4896

识别理由（接口原文）

可见价格轮廓支持快速上涨旗杆、短线回撤整理和放量上破这一组结构，成交量数据也支持bar_index 64为明显放量突破。但15分钟周期、图片无价格坐标、均线和MACD缺失，且突破后不足两个完整交易日，故仅判定为上升旗形candidate，不判定为confirmed。

查询标注：

{
  "tool": "ft_v3_kline_pattern_annotations",
  "arguments": {
    "date": "20260901",
    "symbol": "000089",
    "pattern": "上升旗形",
    "page": 1,
    "page_size": 5
  }
}

获取图片：

{
  "tool": "ft_v3_kline_pattern_image",
  "arguments": {
    "image_hash": "a1eab19298a3d3bbda501330a03879d5984edcc1a64e8c271f529dec8e8f4896"
  }
}

完整请求与返回结果

FTShare 的三种接入方式

接入方式	适合场景	调用形态	仓库
Python SDK	Python 程序、数据分析、量化研究	pandas `DataFrame`、Python rows、原始 JSON	FTShare-python-sdk
MCP	支持 MCP 的 AI 客户端与 Agent	标准 MCP 工具、结构化结果	当前仓库
Skill	Claude Code、Codex、OpenClaw 等 Agent 运行时	自然语言到数据接口的路由	FTShare-skill

三种方式连接同一套 FTShare 金融数据服务。MCP 负责标准化工具调用，Skill 负责自然语言到数据接口的路由。

当前服务

公共地址： https://market.ft.tech/gateway/mcp
传输协议： MCP Streamable HTTP
鉴权方式： FTSHARE_API_KEY HTTP Header
工具属性： 只读金融数据工具
实时工具定义： 以 MCP tools/list 返回的名称、Schema 和 annotations 为准

服务版本、工具数量和账号权限会变化，因此不写入 Hero。发布说明与工具清单应在完成真实 initialize → tools/list → tools/call 验证后更新。

数据能力

A 股行情、K 线、涨跌停、资金流、交易参考与公司数据
ETF、指数、基金、期货、债券和贵金属
港股、美股、宏观经济、公告、研报和财经新闻
FTShare 特色因子：新闻情绪因子、K 线形态标注、相关性 Top-K、信号快照等

数据目录

最新接口、参数、字段、数据权限和更新状态，请查看：

FTShare 最新数据接口文档

当前文档目录覆盖：现货数据、宏观经济、大模型语料、股票数据、美股数据、公募基金、ETF 专题、港股数据、期货数据、债券专题和指数专题。

股票数据进一步包含资金流向、财务、参考、行情、打板专题、两融及转融通、特色数据和基础数据等分类；特色数据已包含 A 股新闻情绪因子、A 股相关性 Top-K、K 线形态标注、供应链关系和信号最新快照等能力。

工具数量、名称和参数以实时 tools/list 为准。仓库文档用于解释能力与示例，不替代服务端 Schema。

协议调用顺序

直接调用 MCP 协议时：

initialize
    ↓ 获取 Mcp-Session-Id
notifications/initialized
    ↓
tools/list
    ↓
tools/call

后续请求需要携带初始化返回的 Session ID、协商后的 MCP 协议版本和 FTSHARE_API_KEY。

常见错误

错误码	含义	建议
`MISSING_PARAMETER`	缺少必填参数	对照实时 `inputSchema` 补充参数
`INVALID_TYPE`	参数类型错误	检查日期、代码和分页字段类型
`UNKNOWN_PARAMETER`	使用了未声明参数	删除 Schema 中不存在的字段
`INVALID_ARGUMENT`	参数值不满足约束	检查日期格式、代码格式和分页上限
`UPSTREAM_REJECTED`	上游或套餐拒绝请求	查看结构化错误信息，核对套餐与接口权限
`UPSTREAM_UNAVAILABLE`	上游服务暂时不可用	根据 `retryable` 与 warnings 判断是否稍后重试

社区与反馈

使用问题与功能建议：GitHub Issues
正式产品与套餐：FTShare
API Key 管理：账号中心
Python SDK：FTShare-python-sdk
Agent Skill：FTShare-skill

加入 FTShare 社区交流群

欢迎加入 FTShare 社区交流群，讨论 MCP 接入、特色因子、金融数据接口、Skill 和 Agent 使用。

群内用于交流使用经验和补充问题信息；Bug、功能需求和工具文档问题建议优先通过 GitHub Issues 提交。

如二维码失效，请在 Issues 中留言。

License

本仓库文档和示例采用 MIT License。开源许可证不自动包含 FTShare 托管数据服务的访问额度、数据授权、再分发权或商业数据使用权。

[!IMPORTANT] 本仓库提供 MCP 工具文档、参数说明和接入示例，不包含 MCP Server 源码。公共 MCP 服务由 FTShare 托管，使用前需要配置 FTSHARE_API_KEY。

FTShare MCP 是什么

60 秒接入

1. 获取 API Key

请求 FTShare MCP 时使用以下 HTTP Header：

FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY

请勿将真实 API Key 提交到 Git 仓库、Issue、日志或公开截图。

2. 配置客户端

Claude Code

claude mcp add --transport http --scope user \
  --header "FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY" \
  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"
http_headers = { FTSHARE_API_KEY = "YOUR_FTSHARE_API_KEY" }

保存后执行：

codex mcp get ftshare

配置变更后新开一个 Codex 任务，使工具定义重新加载。配置文件包含密钥，请勿公开提交。

其他 MCP 客户端

Transport：Streamable HTTP
URL：https://market.ft.tech/gateway/mcp
Header：FTSHARE_API_KEY: YOUR_FTSHARE_API_KEY

不同客户端的字段名称可能不同，请以对应客户端的自定义 HTTP Header 文档为准。

3. 提出一个特色数据问题

使用 FTShare 查询深圳机场（000089）在 2026 年 9 月 1 日的上升旗形标注，返回图片 hash、标注图和识别理由。

返回结果

标的	快照日期	形态	状态	置信度
深圳机场（000089）	2026-09-01	上升旗形	`candidate`	0.58

标注区间：2026-08-27 13:00 至 2026-09-01 14:45。

图片 hash

a1eab19298a3d3bbda501330a03879d5984edcc1a64e8c271f529dec8e8f4896

识别理由（接口原文）

可见价格轮廓支持快速上涨旗杆、短线回撤整理和放量上破这一组结构，成交量数据也支持bar_index 64为明显放量突破。但15分钟周期、图片无价格坐标、均线和MACD缺失，且突破后不足两个完整交易日，故仅判定为上升旗形candidate，不判定为confirmed。

查询标注：

{
  "tool": "ft_v3_kline_pattern_annotations",
  "arguments": {
    "date": "20260901",
    "symbol": "000089",
    "pattern": "上升旗形",
    "page": 1,
    "page_size": 5
  }
}

获取图片：

{
  "tool": "ft_v3_kline_pattern_image",
  "arguments": {
    "image_hash": "a1eab19298a3d3bbda501330a03879d5984edcc1a64e8c271f529dec8e8f4896"
  }
}

完整请求与返回结果

FTShare 的三种接入方式

接入方式	适合场景	调用形态	仓库
Python SDK	Python 程序、数据分析、量化研究	pandas `DataFrame`、Python rows、原始 JSON	FTShare-python-sdk
MCP	支持 MCP 的 AI 客户端与 Agent	标准 MCP 工具、结构化结果	当前仓库
Skill	Claude Code、Codex、OpenClaw 等 Agent 运行时	自然语言到数据接口的路由	FTShare-skill

三种方式连接同一套 FTShare 金融数据服务。MCP 负责标准化工具调用，Skill 负责自然语言到数据接口的路由。

当前服务

公共地址： https://market.ft.tech/gateway/mcp
传输协议： MCP Streamable HTTP
鉴权方式： FTSHARE_API_KEY HTTP Header
工具属性： 只读金融数据工具
实时工具定义： 以 MCP tools/list 返回的名称、Schema 和 annotations 为准

服务版本、工具数量和账号权限会变化，因此不写入 Hero。发布说明与工具清单应在完成真实 initialize → tools/list → tools/call 验证后更新。

数据能力

A 股行情、K 线、涨跌停、资金流、交易参考与公司数据
ETF、指数、基金、期货、债券和贵金属
港股、美股、宏观经济、公告、研报和财经新闻
FTShare 特色因子：新闻情绪因子、K 线形态标注、相关性 Top-K、信号快照等

数据目录

最新接口、参数、字段、数据权限和更新状态，请查看：

FTShare 最新数据接口文档

当前文档目录覆盖：现货数据、宏观经济、大模型语料、股票数据、美股数据、公募基金、ETF 专题、港股数据、期货数据、债券专题和指数专题。

工具数量、名称和参数以实时 tools/list 为准。仓库文档用于解释能力与示例，不替代服务端 Schema。

协议调用顺序

直接调用 MCP 协议时：

initialize
    ↓ 获取 Mcp-Session-Id
notifications/initialized
    ↓
tools/list
    ↓
tools/call

后续请求需要携带初始化返回的 Session ID、协商后的 MCP 协议版本和 FTSHARE_API_KEY。

常见错误

错误码	含义	建议
`MISSING_PARAMETER`	缺少必填参数	对照实时 `inputSchema` 补充参数
`INVALID_TYPE`	参数类型错误	检查日期、代码和分页字段类型
`UNKNOWN_PARAMETER`	使用了未声明参数	删除 Schema 中不存在的字段
`INVALID_ARGUMENT`	参数值不满足约束	检查日期格式、代码格式和分页上限
`UPSTREAM_REJECTED`	上游或套餐拒绝请求	查看结构化错误信息，核对套餐与接口权限
`UPSTREAM_UNAVAILABLE`	上游服务暂时不可用	根据 `retryable` 与 warnings 判断是否稍后重试

社区与反馈

使用问题与功能建议：GitHub Issues
正式产品与套餐：FTShare
API Key 管理：账号中心
Python SDK：FTShare-python-sdk
Agent Skill：FTShare-skill

加入 FTShare 社区交流群

欢迎加入 FTShare 社区交流群，讨论 MCP 接入、特色因子、金融数据接口、Skill 和 Agent 使用。

群内用于交流使用经验和补充问题信息；Bug、功能需求和工具文档问题建议优先通过 GitHub Issues 提交。

如二维码失效，请在 Issues 中留言。

License

本仓库文档和示例采用 MIT License。开源许可证不自动包含 FTShare 托管数据服务的访问额度、数据授权、再分发权或商业数据使用权。

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install FTShare?

Does FTShare need an API key?

What transport does FTShare use?

When was FTShare last checked?

Documentation

FTShare MCP 是什么

60 秒接入

1. 获取 API Key

2. 配置客户端

Claude Code

Codex

其他 MCP 客户端

3. 提出一个特色数据问题

FTShare 的三种接入方式

当前服务

数据能力

数据目录

协议调用顺序

常见错误

社区与反馈

加入 FTShare 社区交流群

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install FTShare?

Does FTShare need an API key?

What transport does FTShare use?

When was FTShare last checked?

Documentation

FTShare MCP 是什么

60 秒接入

1. 获取 API Key

2. 配置客户端

Claude Code

Codex

其他 MCP 客户端

3. 提出一个特色数据问题

FTShare 的三种接入方式

当前服务

数据能力

数据目录

协议调用顺序

常见错误

社区与反馈

加入 FTShare 社区交流群

License