capitalcom-mcp-server 是一个自托管的 Model Context Protocol（MCP）服务器，封装了 Capital.com Open API，使用 Python 基于 FastMCP 编写。项目定位为“安全的、受保护的 LLM 交易”——通过两阶段执行、允许列表和模拟账户优先等机制，把交易能力以 42 个工具的形式提供给各类 MCP 客户端，支持 stdio 或 HTTP 传输，底层基于经过测试的 capitalcom-cli 经纪引擎（SDK）。项目明确标注为非官方、教育用途，与 Capital.com 无关联，交易有风险且不构成财务建议，采用 Apache-2.0 许可。
用途与适用场景：该项目面向希望通过 MCP 客户端（如 Claude Desktop、Claude Code、Cursor、VS Code Copilot、Windsurf、ChatGPT 等）访问 Capital.com 市场数据并进行受控交易的用户。它强调安全默认值：交易默认关闭，所有交易为两阶段（预览 → 确认 → 执行），并要求允许列表和数量/频率限制，建议先在模拟账户上开始。
主要能力：服务器暴露 42 个工具、4 个资源和 7 个引导式提示词。工具名称除 ChatGPT Deep Research 的两个只读适配器（search、fetch）外，均以 cap_ 为前缀。覆盖范围包括会话与账户、交易（读取 → 预览 → 执行 → 管理）、流式数据（WebSocket，需 CAP_WS_ENABLED=true）以及 ChatGPT Deep Research 适配器。提示词是可复用的工作流，客户端可按名称启动，它们只输出分步指导来编排上述工具，自身不会发起交易。
安全与交易控制：除非 CAP_ALLOW_TRADING=true 且 EPIC 位于 CAP_ALLOWED_EPICS（或 ALL）中，否则交易处于关闭状态。两阶段执行，变更类工具需要 confirm=true。设有数量、未平仓头寸和每日订单上限；CAP_DRY_RUN=true 会阻止所有执行。需要特别注意的是，TIMEOUT 确认结果具有歧义——应进行对账，而不是盲目重试。
安装与使用方式：无需克隆，uvx 会在隔离的临时环境中运行并始终获取最新的已测试版本；也可使用 pipx 安装持久命令。对于生产或真实资金使用，建议固定精确版本（例如 uvx capitalcom-mcp==0.3.4 run …），并在阅读 CHANGELOG 后审慎升级。首次使用需在 Capital.com 应用（Settings → API integrations）中获取 API 密钥（建议先创建模拟密钥），然后运行向导生成凭据文件（写入 ~/.config/capital-mcp/.env，权限 0600），向导会打印精确的客户端配置片段。也可通过 CAP_API_KEY_CMD / CAP_IDENTIFIER_CMD / CAP_API_PASSWORD_CMD 指向打印密钥的命令（如 op read、pass），密钥在启动时获取，不会写入磁盘或客户端配置。
客户端配置：各客户端使用相同的 command / args / env 结构。可将 "CAP_ENV_FILE": "<init 输出的路径>" 写入配置以保持密钥不进入客户端文件，或直接在 env 中放入 CAP_API_KEY / CAP_IDENTIFIER / CAP_API_PASSWORD。文档给出了 Claude Desktop（claude_desktop_config.json）、Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）、VS Code Copilot（.vscode/mcp.json，根键为 servers 且 type: "stdio"）、Windsurf（~/.codeium/windsurf/mcp_config.json）等路径示例。ChatGPT 需要远程服务器（不支持 stdio），需通过 HTTPS 可达后，在 Developer Mode（Settings → Connectors → Advanced）中添加以 /mcp 结尾的服务器 URL；ChatGPT Deep Research 连接器会调用两个只读工具 search 和 fetch，完整自定义工具需 Developer Mode。
远程 / VPS 托管：可使用 streamable-HTTP 而非 stdio 运行，或通过环境变量（CAP_MCP_TRANSPORT=http、CAP_MCP_HOST、CAP_MCP_PORT，适合 systemd）。任何公开使用都应置于终止 TLS 的反向代理之后。
测试与贡献：端到端测试会通过 MCP 针对演示 API 驱动每个工具（读取、自选列表、账户切换、预览/执行/修改/平仓/取消、流式），会下真实模拟订单并自行清理，因此应使用启用了交易与流式功能的模拟 .env。项目欢迎社区贡献，提供了 CONTRIBUTING.md、good first issues、路线图以及 docs/extending.md 中的架构与“添加工具”示例。
限制与风险：项目为非官方，与 Capital.com 无关联；交易有风险，不构成财务建议；交易默认关闭，必须显式开启并满足允许列表；存在数量、头寸与每日订单上限；CAP_DRY_RUN 可阻止执行；TIMEOUT 确认结果需人工对账而非重试。资料未提供具体的工具清单、提示词名称、各客户端配置的完整示例、定价信息或性能数据。
