FTShare MCP

中文 | English

FTShare-MCP 是 FTShare 金融数据能力的 MCP 工具文档与接入说明仓库，面向支持 MCP 的客户端、Agent 应用和自动化投研流程，提供公共 MCP 入口、调用流程、工具索引、参数说明和示例。

面向国际开发者，本仓库也可以被理解为 FTShare MCP tools for financial data, market data, quantitative research and AI Agent investment workflows。

当前仓库重点是 MCP 工具文档与接入说明，不包含 MCP Server 源码。公共 MCP 服务由 FTShare 数据服务提供。

当前文档重点覆盖 FTShare 正式开放的 150 个 ft_* 金融数据工具，覆盖行情、财务、宏观、基金、期货、债券、美股、港股等数据；测试、示例或内部辅助工具不作为正式文档入口展示。

MCP 公共入口

本文档统一使用 <MCP_BASE_URL> 表示 MCP Streamable HTTP 入口。公共 MCP 入口为：

MCP_BASE_URL="https://market.ft.tech/gateway/mcp"

复制各工具文档示例时，请把 <MCP_BASE_URL> 替换为上面的地址。

• MCP 入口占位符：<MCP_BASE_URL>（Streamable HTTP）
• 协议要点：先 initialize 拿 Mcp-Session-Id，再 tools/call
• 返回格式：markdown 表格文本（非结构化 JSON）
• 查实时 schema：tools/list 返回每个工具的 inputSchema

适用场景

• Claude Code、Codex、Cursor、OpenClaw 等支持 MCP 的客户端
• Agent 投研工作流中的金融数据工具调用
• 自动化行情、财务、宏观、基金、期货、债券、美股、港股数据查询
• 面向投研、量化研究和金融应用开发的数据接入验证

调用流程

1. 确认 MCP 入口：公共环境使用 https://market.ft.tech/gateway/mcp，各工具文档中的 <MCP_BASE_URL> 都替换为这个地址。
2. 选择工具：从下方工具索引或 tools/list 结果中找到目标 ft_* 工具名。
3. 查看参数：每个工具文档都列出输入参数、是否必填、输出字段和数据样例；tools/list 也会返回实时 inputSchema。
4. 初始化会话：第一次请求先调用 MCP initialize，拿到 Mcp-Session-Id。
5. 调用工具：后续请求带上 Mcp-Session-Id，调用 tools/call，其中 name 是工具名，arguments 是业务参数。
6. 读取结果：ft_* 工具默认返回 markdown 表格文本；如果需要结构化字段，请优先参考对应文档的输出参数表。
7. 处理错误：HTTP 非 2xx、MCP 协议错误、工具参数错误或服务端业务错误都应在客户端侧捕获并展示；调试时建议先调用 tools/list 校验工具名和参数 schema。

通用 Demo

下面示例可调用任意 ft_* 工具。只需要改 TOOL_NAME 和 TOOL_ARGS，就可以复用到各个文档里的工具。

curl

# MCP 服务入口；等同于文档里的 <MCP_BASE_URL>。
MCP_BASE_URL="https://market.ft.tech/gateway/mcp"

# 要调用的 MCP 工具名；可在下方工具索引或 tools/list 结果中查询。
TOOL_NAME="ft_get_cb_lists_handler"

# 工具业务参数；无参数工具传 {}，有参数时按对应工具文档填写 JSON 对象。
TOOL_ARGS='{}'

# initialize 请求体；用于创建 MCP 会话。
INIT_PAYLOAD='{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl-demo","version":"1.0.0"}}}'

# tools/call 请求体；name 是工具名，arguments 是工具业务参数。
CALL_PAYLOAD="{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"${TOOL_NAME}\",\"arguments\":${TOOL_ARGS}}}"

# 先调用 initialize，并从响应头中提取 Mcp-Session-Id。
MCP_SESSION_ID=$(curl -sS -m 10 -D - -o /dev/null -X POST "$MCP_BASE_URL" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d "$INIT_PAYLOAD" \
  | awk 'tolower($1)=="mcp-session-id:" {print $2}' \
  | tr -d '\r')

# 带上 Mcp-Session-Id 调用目标工具；返回内容通常是 markdown 表格文本。
curl -sS -m 30 -X POST "$MCP_BASE_URL" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -H "Mcp-Session-Id: $MCP_SESSION_ID" \
  -d "$CALL_PAYLOAD"

Python

下面示例使用 Python MCP 客户端库调用任意 ft_* 工具。

依赖安装（Python 3.10+）：pip install mcp

import asyncio  # 运行异步 main 函数。
from mcp import ClientSession  # MCP 客户端会话对象，用于 initialize、tools/list、tools/call。
from mcp.client.streamable_http import streamablehttp_client  # Streamable HTTP 客户端连接工具。

MCP_BASE_URL = "https://market.ft.tech/gateway/mcp"  # 实际公共 MCP 入口；等同于文档里的 <MCP_BASE_URL>。
TOOL_NAME = "ft_get_cb_lists_handler"  # 要调用的 MCP 工具名；可在下方工具索引或 tools/list 结果中查询。
TOOL_ARGS = {}  # 工具业务参数；无参数工具传空字典，有参数时按对应工具文档填写。

async def main():  # 定义异步入口函数。
    async with streamablehttp_client(  # 建立 MCP Streamable HTTP 连接。
        MCP_BASE_URL,  # MCP 服务入口地址。
    ) as (read_stream, write_stream, _):  # read_stream 读响应，write_stream 写请求，第三个返回值此处无需使用。
        async with ClientSession(  # 创建 MCP 客户端会话。
            read_stream,  # 服务端响应读取流。
            write_stream,  # 客户端请求写入流。
        ) as session:  # session 用于调用 MCP 协议方法。
            await session.initialize()  # 初始化协议并完成会话握手。

            tools = await session.list_tools()  # 可选：获取当前服务端可用工具列表。
            print([tool.name for tool in tools.tools])  # 可选：打印工具名，确认 TOOL_NAME 是否存在。

            result = await session.call_tool(  # 调用指定 MCP 工具。
                TOOL_NAME,  # params.name：工具名。
                TOOL_ARGS,  # params.arguments：传给工具的业务参数。
            )  # result.content 通常包含工具返回内容。

            print(result.content[0].text)  # 打印第一个文本结果；ft_* 工具默认返回 markdown 表格。

asyncio.run(main())  # 启动异步程序。

社区交流

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

群规说明：

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

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

相关项目

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

按数据目录

大类	工具数	文档目录
ETF专题	8	ETF专题/
债券专题	2	债券专题/
公募基金	5	公募基金/
外汇数据	1	外汇数据/
大模型语料	5	大模型语料/
宏观经济	17	宏观经济/
指数专题	8	指数专题/
期货数据	7	期货数据/
港股数据	7	港股数据/
现货数据	2	现货数据/
美股数据	7	美股数据/
股票数据	81	股票数据/

工具索引

MCP 工具	标题	数据目录	文档
ft_etf_adjust_factor	ETF复权因子	ETF专题	ETF专题/ETF复权因子.md
ft_etf_components_all	ETF成份列表	ETF专题	ETF专题/ETF成份列表.md
ft_etf_description_all	ETF基础信息	ETF专题	ETF专题/ETF基础信息.md
ft_etf_fund_export	指数ETF基金导出	ETF专题	ETF专题/指数ETF基金导出.md
ft_etf_pcf_list_handler	ETF-PCF清单列表	ETF专题	ETF专题/ETF-PCF清单列表.md
ft_get_etf_components_handler	ETF成份股	ETF专题	ETF专题/ETF成份股.md
ft_get_etf_pre	ETF盘前数据	ETF专题	ETF专题/ETF盘前数据.md
ft_get_etf_pre_single_handler	单只ETF盘前数据	ETF专题	ETF专题/单只ETF盘前数据.md
ft_get_cb_base_data_handler	可转债基础数据	债券专题	债券专题/可转债基础数据.md
ft_get_cb_lists_handler	可转债列表	债券专题	债券专题/可转债列表.md