第 4 章 · 04 MCP 服务

第 4 章 · 04 MCP 服务

本节摘要:前面三节(Shadow Account / swarm / 技能库)都是在 Vibe-Trading 自己的 CLI 或 Web UI 里用。MCP 服务让你把 Vibe-Trading 的全部能力,暴露给你已经习惯的 AI 客户端——Claude Desktop、Cursor、OpenClaw 等。它作为一个 stdio 子进程运行,把「技能 / 行情 / 回测 / 因子 / 期权 / 文档读取 / 交易流水 / Shadow Account / swarm」都变成 agent 可调用的工具。本节讲清 MCP 服务的启动方式、客户端配置、暴露的工具面,以及它和 CLI 模式的取舍。读完本节,你能把 Vibe-Trading 接进你最顺手的 AI 客户端,用自然语言驱动完整的金融研究。

内容来源:原项目英文文档 reference/mcp-server。

学习目标

阅读完本节,你应当能够:

1. 说清 MCP 服务的定位(把 Vibe-Trading 工具暴露给外部 AI 客户端,作为 stdio 子进程)。
2. 启动 MCP 服务并在 Claude Desktop / Cursor 等客户端里配置。
3. 列举它暴露的工具面(技能/行情/回测/因子/期权/文档/流水/Shadow Account/swarm)。
4. 理解 MCP 模式 vs CLI 模式的取舍。

一、MCP 服务是什么:把能力暴露给外部客户端

MCP(Model Context Protocol,模型上下文协议)是让 AI 客户端统一调用外部工具的标准协议。Vibe-Trading 提供一个 MCP 服务,意味着:

你不必非得在 Vibe-Trading 自己的界面里做研究——可以在 Claude Desktop、Cursor、OpenClaw 等你日常用的 AI 客户端里,用自然语言下指令,客户端通过 MCP 调用 Vibe-Trading 的工具(拉行情、跑回测、做因子分析、跑 swarm……)。

Vibe-Trading 的 MCP 服务作为一个 stdio 子进程运行:客户端启动它、通过标准输入输出与它通信,它再把请求转给 Vibe-Trading 的工具层。

💡 为什么用 MCP:如果你的工作流本来就在 Claude Desktop / Cursor 里(写代码、查资料),不必为了做金融研究切换到另一个工具——MCP 让你在同一个客户端里「顺手」调用 Vibe-Trading,降低上下文切换成本。

二、启动与客户端配置

启动 MCP 服务

vibe-trading-mcp
​

这会以 stdio 模式启动 MCP 服务,等待客户端连接。

客户端配置(以 Claude Desktop 为例)

在 MCP 客户端的配置文件里,把 vibe-trading-mcp 注册为一个 server:

{
  "mcpServers": {
    "vibe-trading": {
      "command": "vibe-trading-mcp"
    }
  }
}
​

配置好后,客户端会自动启动这个子进程,并发现它暴露的全部工具。Cursor 等客户端的配置方式类似(在各自的 MCP 设置里加同样的 server 条目)。

💡 配置后验证:在客户端里问一句需要调用 Vibe-Trading 的话(例如「查一下 BTC-USDT 最近行情」),如果客户端成功调用了行情工具并返回数据,说明 MCP 接入成功。

三、暴露的工具面

Vibe-Trading 的 MCP 服务暴露的工具覆盖前面所有章节讲过的能力:

💡 MCP 把前面所有能力统一成一个入口:无论你用的是 CLI、Web UI 还是 MCP,底层调用的是同一套工具层——只是交互界面不同。这意味着你在哪学到的用法(回测怎么配、因子怎么读)在 MCP 模式下完全通用。

四、MCP 模式 vs CLI 模式:怎么选

💡 选择建议:纯做金融研究、要看流式 swarm 进度 → CLI/Web UI;日常在 Claude/Cursor 里写代码、偶尔做研究 → MCP 模式,减少切换。两者底层一致,可并用。

本节要点回顾

1. 定位:MCP 服务把 Vibe-Trading 全部能力暴露给 Claude Desktop/Cursor/OpenClaw 等外部客户端,作为 stdio 子进程运行。
2. 启动:vibe-trading-mcp;客户端配置里注册 {"command":"vibe-trading-mcp"}。
3. 工具面:技能/行情/回测/因子/期权/文档/流水/Shadow Account/swarm,覆盖前述所有章节。
4. 底层一致:CLI、Web UI、MCP 三种界面调用同一套工具层,学到的用法通用。
5. 模式取舍:专注研究用 CLI/Web(swarm 体验好);日常在 AI 客户端里工作用 MCP(减少切换);可并用。
6. 验证:配置后在客户端问一句需调用行情/回测的话,返回数据即接入成功。

⚠️ 本节及整个教程不构成投资建议。通过 MCP 调用的实盘相关工具,同样受 read-only/paper 优先的安全约束(见第 3 章)。

至此,第 4 章「工具与进阶」全部完成——Shadow Account 复盘自己、swarm 委员会研究、金融技能库、MCP 服务。回到「教程总纲.md」可回顾全书结构,或参考「教程规划.md」的术语库与待汉化清单。