一、什么是 MCP？

MCP（Model Context Protocol）是 Anthropic 提出的一种开放协议，用于让 AI 模型与外部数据源和工具进行标准化交互。简单来说，它就像 AI 世界的"USB 接口"——只要服务端实现了 MCP 协议，任何支持 MCP 的客户端（Cherry Studio、Claude Desktop、OpenClaw 等）都能直接调用其功能。

金融数据领域一直存在一个痛点：AI 模型的训练数据有截止日期，无法获取实时行情和最新财报。通过 MCP，我们可以让 AI 直接连接到实时金融数据源，真正实现"活的"金融助手。

二、金融数据 MCP Server 简介

金融数据 MCP Server 提供覆盖 A 股、港股、美股三大市场的一站式金融数据服务。

核心能力

能力	说明
🌏 三大市场覆盖	A 股、港股、美股全市场数据
📊 F10 基本面	公司简况、财务报表、基础信息、基金持仓
📈 SDK 深度数据	盘口、资金流向、筹码分布、K 线图表、行业排行
🔍 智能代码检索	自然语言搜索证券代码，自动匹配市场
🔌 双传输协议	同时支持 Streamable HTTP 和 SSE
🤖 AI-Native	专为 Cherry Studio、OpenClaw 等 AI 助手设计

架构概览

┌─────────────────────────────────────────────────────┐
│                  AI 客户端                            │
│   Cherry Studio / OpenClaw / Claude Desktop          │
└────────────────────┬────────────────────────────────┘
                     │ MCP Protocol (Streamable HTTP / SSE)
                     ▼
┌─────────────────────────────────────────────────────┐
│               MCP Server                          │
│  ┌──────────┬──────────┬──────────┬────────┐         │
│  │ A 股 F10 │ 港股 F10 │ 美股 F10 │Toolkit │         │
│  └──────────┴──────────┴──────────┴────────┘         │
│  ┌──────────┬──────────┬──────────┐                  │
│  │ A 股 SDK │ 港股 SDK │ 美股 SDK │                  │
│  └──────────┴──────────┴──────────┘                  │
└─────────────────────────────────────────────────────┘
                     │
                     ▼
┌─────────────────────────────────────────────────────┐
│              金融数据源                               │
│   实时行情 / 财务报表 / 资金流向 / K 线数据            │
└─────────────────────────────────────────────────────┘

三、快速开始——Cherry Studio 配置

3.1 获取 API Key

前往 https://ai.szfiu.com/login 注册账号并生成 JWT Token。

3.2 JSON 配置

在 Cherry Studio 的 MCP 设置中添加以下配置：

{
  "mcpServers": {
    "fiu-cn-f10": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_cn_f10/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-hk-f10": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_hk_f10/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-us-f10": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_us_f10/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-cn-sdk": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_cn_sdk/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-hk-sdk": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_hk_sdk/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-us-sdk": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/stock_us_sdk/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    },
    "fiu-toolkit": {
      "transport": "streamable_http",
      "url": "https://ai.szfiu.com/api/mcp/toolkit/"
    }
  }
}

注意： 所有 endpoint URL 必须以 / 结尾，否则可能请求失败。

3.3 推荐 System Prompt

你是金融助手。
- 查询数据前，请先使用 toolkit 确认证券代码
- 使用 MCP 工具查询实时数据，分析用户问题
- 建议搭配 time MCP server 获取当前日期

3.4 实际使用效果

配置完成后，你可以直接用自然语言提问：

• "贵州茅台怎么样？" → AI 自动调用 F10 工具，返回公司简况、财务摘要
• "腾讯控股上个季度业绩如何？" → AI 查询港股财务数据并分析
• "苹果公司利润表" → AI 获取美股财务报表并解读
• "00700 的资金流向" → AI 调用 SDK 工具返回资金流入流出数据

四、OpenClaw Skills——更轻量的使用方式

如果你使用 OpenClaw 作为 AI 助手，可以通过安装 Skill 来获得更便捷的金融数据查询能力。

4.1 一行安装

npx clawhub@latest install fiu-market-assistant

4.2 配置 Token

/fiu-market-assistant setup 你的FIU_MCP_TOKEN

4.3 自然语言查询

安装完成后，直接对话即可：

查询腾讯控股行情
显示 AAPL 日线K线
00700 的资金流向如何？

4.4 MCP Router 脚本

Skills 内置了 mcp_router.sh 统一路由脚本，可以在命令行直接调用：

# 查询港股实时行情
mcp_router.sh hk_sdk post_v3_stock_quote fields=snapshot symbol=00700.HK

# 查询 K 线数据
mcp_router.sh hk_sdk post_v3_chart_kline_list symbol=00700.HK type=0

# 搜索股票代码
mcp_router.sh toolkit search key=腾讯

五、MCP Server 工具列表

5.1 F10 基本面工具

Server	市场	描述	Endpoint
stockCnF10	A 股	公司简况、财务、基础信息	/api/mcp/stock_cn_f10/
stockHkF10	港股	公司简况、财务、基金持仓	/api/mcp/stock_hk_f10/
stockUsF10	美股	公司简况、财务、基础信息	/api/mcp/stock_us_f10/

5.2 SDK 深度数据工具

Server	市场	描述	Endpoint
stockCnSdk	A 股	盘口、资金流、K 线、筹码	/api/mcp/stock_cn_sdk/
stockHkSdk	港股	盘口、资金流、K 线、筹码	/api/mcp/stock_hk_sdk/
stockUsSdk	美股	盘口、资金流、K 线、筹码	/api/mcp/stock_us_sdk/

5.3 工具集

Server	描述	Endpoint
szfiuToolkit	证券代码检索	/api/mcp/toolkit/

六、注意事项与最佳实践

6.1 搭配 Time MCP Server

AI 模型的内部时间感知可能不准确，建议同时添加 time MCP server，这样 AI 能传递准确的日期参数：

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-time"]
    }
  }
}

6.2 按需启用工具

不需要同时启用所有 MCP Server。根据你的需求选择：

• 只查 A 股 → 启用 fiu-cn-f10 + fiu-cn-sdk
• 只查港股 → 启用 fiu-hk-f10 + fiu-hk-sdk
• 全市场 → 全部启用

6.3 代码确认

查询前建议先用 szfiuToolkit 确认正确的证券代码，避免因代码错误导致查询失败。

6.4 传输协议选择

默认使用 Streamable HTTP，如果需要 SSE 传输，将 URL 中的 /api/mcp/ 替换为 /api/mcp/sse/ 即可：

https://ai.szfiu.com/api/mcp/sse/stock_cn_f10/

七、项目地址

• FIU MCP Server： https://github.com/fiu-ai/mcp-server
• OpenClaw Skills： https://github.com/fiu-ai/openclaw-skills
• ClawHub： fiu-market-assistant
• API 注册： https://ai.szfiu.com/login
• 完整文档： https://ai.szfiu.com

八、总结

通过 MCP 协议，我们成功让 AI 助手具备了实时金融数据查询能力。无论是投资研究、行情跟踪还是财务分析，都能通过自然语言直接完成，大幅提升了工作效率。

FIU MCP Server 覆盖了 A 股、港股、美股三大市场，提供了从基础 F10 到深度 SDK 数据的全方位支持。配合 Cherry Studio 或 OpenClaw 使用，可以打造属于自己的 AI 金融助手。

如果你对 MCP 协议或金融数据查询有任何疑问，欢迎在评论区交流！