Token导航 LogoToken导航TokenDH.com
Capitalcom MCP Server logo
金融服务stdio官方级别未说明来源级核验

Capitalcom MCP Server

MCP Server

Capital.com的MCP服务器,提供安全的LLM驱动交易操作,适用于金融交易和教育研究。

工具数

0

提示词数

0

GitHub Stars

0

资源数

0
金融交易风险管理PythonClaude教育工具Claude DesktopClaudeCursorWindsurf

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

SimonTarara62

提供方

SimonTarara62

最后核验

2026/5/17 20:22

运行时

Python

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

python3 -m venv venv

详细介绍

Capital.com MCP服务器

Capital.com Open API的模型上下文协议(MCP)服务器-实现安全、LLM驱动的交易操作。

⚠️ 免责声明:这是一个 非官方、社区建设 项目仅用于教育和学习目的。它是 隶属于Capital.com,由Capital.com认可或官方支持。这是Capital.com开放API的独立实施,用于研究和学习目的。

⚠️ 重要安全须知

交易是有风险的。此软件用于工程/教育目的,不是财务建议。

  • 这是一个 非官方社区项目 -不是Capital.com的官方产品
  • 总是以a开头 模拟帐户 在考虑进行实时交易之前
  • 交易是 默认禁用 并且需要显式配置
  • 所有贸易操作都需要 两阶段执行 (预览→ 确认→ 执行)
  • 内置风险控制:配额制度、规模限制、每日订单上限
  • 使用风险自负 -作者对交易损失不承担任何责任

当前实施状态

总体:完成95% (第1-7阶段完成,WebSocket流媒体实现)

✅ 已完成(第1-7阶段)

基础和基础设施

  • ✅ 使用pyproject.toml的项目结构,配置了依赖关系
  • ✅ 具有环境变量验证的配置系统
  • ✅ 使用Pydantic的核心数据模型(枚举、请求、响应)
  • ✅ 错误处理(错误代码、自定义异常、秘密编辑)
  • ✅ 速率限制(令牌桶、异步安全、多层)
  • ✅ HTTP客户端(httpx、重试、超时处理、日志记录)
  • ✅ 会话管理(自动登录、令牌刷新、保持活动)
  • ✅ 风险引擎(预览缓存、大小标准化、交易保护)
  • ✅ WebSocket客户端(流媒体、自动重新连接、订阅管理)

MCP服务器和工具(已实施36个工具)

  • ✅ 带STDIO传输的FastMCP服务器
  • ✅ 会话工具(4)-状态、登录、ping、注销
  • ✅ 市场数据工具(6)-搜索、获取、价格、情绪、导航
  • ✅ 账户工具(6)-列表、偏好、历史记录、演示充值
  • ✅ 交易工具(14)-头寸、订单、预览、执行、关闭、取消
  • ✅ 监视列表工具(6)-列表、获取、创建、添加、删除、移除
  • ✅ WebSocket流媒体工具(3)-流媒体价格、警报、投资组合损益

MCP提示(已实施7个工作流模板)

  • ✅ market_scan-扫描观察名单以寻找交易机会
  • ✅ trade_posal-设计交易与风险管理
  • ✅ execute_trade-安全执行预览交易
  • ✅ position_review-分析投资组合头寸和订单
  • ✅ live_price_monitor-带有警报的实时价格跟踪(WebSocket)
  • ✅ real_time_alerts-价格水平的即时通知(WebSocket)
  • ✅ live_portfolio_mmonitor-实时损益跟踪(WebSocket)

MCP资源(已实现4个只读资源)

  • ✅ cap://status-服务器和会话状态
  • ✅ cap://risk-policy-风险管理配置
  • ✅ cap://allowed-epics-交易对手
  • ✅ cap://market-cache/{epic}-市场详情(动态)

✅ 测试(第7阶段)

测试套件

  • ✅ 测试基础设施(pytest、pytest-asyncio、pytest-mock、pytest-cov)
  • ✅ 基本健全性测试(导入、错误定义、MCP服务器实例)
  • ✅ MCP注册测试(36个工具、4个资源、7个提示)
  • ✅ 快速验证测试(描述、参数)
  • ✅ WebSocket客户端测试(连接、订阅、消息解析)
  • ✅ WebSocket模型测试(PriceTick、StreamAlert、PortfolioSnapshot)
  • ⏳ 核心部件的单元试验(延迟紧耦合)
  • ⏳ 模拟API集成测试(延迟-紧密耦合)

📋 待定

可选功能

  • ⏳ 缺少2个工具(更新位置、更新顺序)

快速入门指南

步骤1:获取Capital.com API证书

  1. 创建账户首选 capital.com/tradin/signup

- 选择 演示 测试说明(推荐) - 验证您的邮箱

  1. 启用2FA:设置>安全>双因素身份验证

- 生成API密钥之前需要

  1. 生成API密钥:设置>API集成>生成新密钥

- 设置标签(例如“MCP服务器”) - 设置自定义密码 (这不是您的平台密码) - 保存显示的API密钥(仅显示一次!) - 注:API密钥是可交易的;Capital.com不提供只读密钥

步骤2:安装和配置

# Navigate to project directory
cd /path/to/capital-mcp

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

# Copy and configure environment file
cp .env.example .env

编辑 .env 使用您的凭据:

# Required
CAP_ENV=demo
CAP_API_KEY=your_generated_api_key_here
CAP_IDENTIFIER=your_email@example.com
CAP_API_PASSWORD=your_custom_api_password

# Safety (keep trading disabled until ready)
CAP_ALLOW_TRADING=false
CAP_ALLOWED_EPICS=

# Optional: enable later for real trading
# CAP_ALLOW_TRADING=true
# CAP_ALLOWED_EPICS=SILVER,GOLD,BTCUSD

步骤3:在本地测试服务器

# Activate venv if not already
source venv/bin/activate

# Run server directly (for testing)
python -m capital_mcp.server

# You should see:
# INFO - Starting Capital.com MCP Server (env: demo)
# INFO - Trading enabled: False

# Press Ctrl+C to stop

故障排除:检查日志

如果您在将MCP服务器与Claude Desktop或其他客户端一起使用时遇到问题,请检查日志文件:

macOS:

# View MCP server logs
tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log

# Search for errors
grep -i error ~/Library/Logs/Claude/mcp-server-capital-com.log

Linux:

tail -f ~/.config/Claude/logs/mcp-server-capital-com.log

视窗:

Get-Content $env:APPDATA\Claude\logs\mcp-server-capital-com.log -Wait

与Claude Desktop集成

macOS/Linux安装程序

  1. 查找Claude Desktop配置位置:
   # macOS
   ~/Library/Application Support/Claude/claude_desktop_config.json

   # Linux
   ~/.config/Claude/claude_desktop_config.json
  1. 编辑 claude_desktop_config.json:
   {
     "mcpServers": {
       "capital-com": {
         "command": "/path/to/capital-mcp/venv/bin/python",
         "args": ["-m", "capital_mcp.server"],
         "env": {
           "CAP_ENV": "demo",
           "CAP_API_KEY": "your_api_key_here",
           "CAP_IDENTIFIER": "your_email@example.com",
           "CAP_API_PASSWORD": "your_custom_password",
           "CAP_ALLOW_TRADING": "false",
           "CAP_ALLOWED_EPICS": ""
         }
       }
     }
   }

重要:替换 /path/to/capital-mcp/venv/bin/python 使用您的实际虚拟环境Python路径。通过运行获得它:

   cd /path/to/capital-mcp
   source venv/bin/activate
   which python
  1. 重新启动克劳德桌面
  1. 在Claude Desktop中验证:

- 寻找🔌 图标或“MCP”指示器 - 类型:“Capital.com提供哪些工具?” - Claude应该列出36个可用的工具

Windows安装程序

  1. 查找Claude桌面配置:
   %APPDATA%\Claude\claude_desktop_config.json
  1. 编辑配置(使用Windows路径):
   {
     "mcpServers": {
       "capital-com": {
         "command": "C:\\path\\to\\capital-mcp\\venv\\Scripts\\python.exe",
         "args": ["-m", "capital_mcp.server"],
         "env": {
           "CAP_ENV": "demo",
           "CAP_API_KEY": "your_api_key_here",
           "CAP_IDENTIFIER": "your_email@example.com",
           "CAP_API_PASSWORD": "your_custom_password",
           "CAP_ALLOW_TRADING": "false",
           "CAP_ALLOWED_EPICS": ""
         }
       }
     }
   }
  1. 重新启动克劳德桌面

与Cursor IDE集成

  1. 打开光标设置: Cmd+, (Mac)或 Ctrl+, (Windows/Linux)
  1. 引导到:扩展>MCP>配置
  1. 添加服务器配置 (类似于克劳德桌面):
   {
     "capital-com": {
       "command": "/path/to/capital-mcp/venv/bin/python",
       "args": ["-m", "capital_mcp.server"],
       "env": {
         "CAP_ENV": "demo",
         "CAP_API_KEY": "your_api_key_here",
         "CAP_IDENTIFIER": "your_email@example.com",
         "CAP_API_PASSWORD": "your_custom_password",
         "CAP_ALLOW_TRADING": "false"
       }
     }
   }
  1. 重新启动游标
  1. AI聊天测试:询问“列出我的Capital.com帐户”

与Windsurf集成

  1. 创建/编辑Windsurf MCP配置:
   mkdir -p ~/.windsurf/mcp
   nano ~/.windsurf/mcp/servers.json
  1. 添加配置:
   {
     "mcpServers": {
       "capital-com": {
         "command": "/path/to/capital-mcp/venv/bin/python",
         "args": ["-m", "capital_mcp.server"],
         "env": {
           "CAP_ENV": "demo",
           "CAP_API_KEY": "your_api_key_here",
           "CAP_IDENTIFIER": "your_email@example.com",
           "CAP_API_PASSWORD": "your_custom_password"
         }
       }
     }
   }
  1. 重新启动Windsurf

与自定义MCP客户端集成

如果您正在构建自己的MCP客户端或使用其他工具:

// Example: Node.js MCP client
import { spawn } from 'child_process';

const server = spawn('/path/to/venv/bin/python', ['-m', 'capital_mcp.server'], {
  env: {
    ...process.env,
    CAP_ENV: 'demo',
    CAP_API_KEY: 'your_key',
    CAP_IDENTIFIER: 'your_email',
    CAP_API_PASSWORD: 'your_password',
    CAP_ALLOW_TRADING: 'false'
  }
});

// Communicate via STDIO (JSON-RPC)
// Read from server.stdout, write to server.stdin

使用服务器

与Claude Desktop的对话示例

You: "Check my Capital.com session status"

Claude: I'll check your session status.
[Calls cap_session_status]
Response: {"ok": true, "data": {"env": "demo", "logged_in": false, ...}}

You're not currently logged in to the demo environment.

---

You: "Login to my Capital.com account"

Claude: I'll log you in.
[Calls cap_session_login]
Success! Logged in to account ID: ABC123

---

You: "Search for Bitcoin markets"

Claude: Searching for Bitcoin...
[Calls cap_market_search with search_term="Bitcoin"]
Found 5 markets:
- BTCUSD: Bitcoin vs US Dollar
- BTCEUR: Bitcoin vs Euro
- BTCGBP: Bitcoin vs British Pound
...

---

You: "Show me current positions"

Claude: Let me check your positions.
[Calls cap_trade_positions_list]
You have no open positions.

---

You: "Preview buying 1.0 SILVER"

Claude: I'll preview this trade. Note: Trading is currently DISABLED.
[Calls cap_trade_preview_position]
Preview failed: Trading is disabled (CAP_ALLOW_TRADING=false)

To enable trading, update your .env file:
CAP_ALLOW_TRADING=true
CAP_ALLOWED_EPICS=SILVER

安全交易工作流程(启用交易时)

1. Preview the trade (validates everything, no side effects):
   "Preview buying 2.0 SILVER with stop at 24.50"
   → Returns preview_id

2. Review the preview results:
   - Normalized size (rounded to broker increments)
   - Risk checks (allowlist, size limits, daily limits)
   - Estimated entry price

3. Execute ONLY if all checks pass:
   "Execute position with preview_id [id], confirm=true"
   → Creates real position
   → Returns deal_reference
   → Polls for broker confirmation

4. Monitor:
   "Show my positions"
   "Close position [deal_id] with confirm=true"

建筑

LLM Client (Claude Desktop/Cursor)
  ↕ STDIO (JSON-RPC)
MCP Server (capital_mcp/)
  ├─ server.py          # FastMCP server + tool registrations
  ├─ session.py         # SessionManager (login, refresh, ping)
  ├─ capital_client.py  # HTTP client (httpx, rate limits)
  ├─ risk.py            # RiskEngine (preview, validation)
  ├─ config.py          # Configuration (env vars)
  ├─ models.py          # Pydantic data models
  ├─ errors.py          # Error codes & exceptions
  ├─ rate_limit.py      # Token bucket rate limiter
  └─ utils.py           # Helper functions

环境变量引用

必需

  • CAP_ENV -环境: demolive (默认:演示)
  • CAP_API_KEY -Capital.com提供的API密钥
  • CAP_IDENTIFIER -登录邮箱
  • CAP_API_PASSWORD -API密钥自定义密码

安全控制(推荐)

  • CAP_ALLOW_TRADING -启用交易(默认值:false)
  • CAP_ALLOWED_EPICS -逗号分隔的allowlist(例如,“SILVER、GOLD、BTCUSD”)或“ALL”表示无限制
  • CAP_MAX_POSITION_SIZE -最大位置大小(默认值:1.0)
  • CAP_MAX_WORKING_ORDER_SIZE -最大订单大小(默认值:1.0)
  • CAP_MAX_OPEN_POSITIONS -最大并发位置(默认值:3)
  • CAP_MAX_ORDERS_PER_DAY -每日订单限额(默认值:20)
  • CAP_REQUIRE_EXPLICIT_CONFIRM -需要确认=真(默认值:真)
  • CAP_DRY_RUN -阻止所有交易执行(默认值:false)

可选的

  • CAP_DEFAULT_ACCOUNT_ID -登录后的默认帐户
  • CAP_HTTP_TIMEOUT_S -HTTP超时(默认值:15)
  • CAP_LOG_LEVEL -日志级别:调试、信息、警告、错误(默认值:信息)

MCP工具(已实施36个)

会议(4)

  • cap.session.status -获取会话信息
  • cap.session.login -创建会话
  • cap.session.ping -活下去
  • cap.session.logout -结束会话

市场数据(6)

  • cap.market.search -搜索市场
  • cap.market.get -获取市场详细信息
  • cap.market.prices -历史价格
  • cap.market.sentiment -客户情绪
  • cap.market.navigation_root -市场类别根
  • cap.market.navigation_node -市场类别节点

账户(6)

  • cap.account.list -列出帐户
  • cap.account.preferences.get -获取首选项
  • cap.account.preferences.set -设置首选项
  • cap.account.history.activity -活动历史
  • cap.account.history.transactions -交易历史
  • cap.account.demo.topup -充值模拟账户

贸易(14)

  • 只读:

- cap.trade.positions.list -列出职位 - cap.trade.positions.get -获取职位详细信息 - cap.trade.orders.list -列出工作订单 - cap.trade.confirm.get -获取确认状态 - cap.trade.confirm.wait -等待确认

  • 预览(安全):

- cap.trade.preview_position -预览位置 - cap.trade.preview_working_order -预览订单

  • 执行(受保护):

- cap.trade.execute_position -执行职位 - cap.trade.execute_working_order -执行订单 - cap.trade.positions.update -更新职位 - cap.trade.positions.close -关闭位置 - cap.trade.orders.update -更新订单 - cap.trade.orders.cancel -取消订单

观察名单(6)

  • cap.watchlists.list -列出观察名单
  • cap.watchlists.create -创建监视列表
  • cap.watchlists.get -获取观察名单
  • cap.watchlists.add_market -添加市场
  • cap.watchlists.delete -删除监视列表
  • cap.watchlists.remove_market -移除市场

MCP提示(工作流模板)

MCP提示是结构化的工作流程,指导克劳德完成复杂的多步骤交易操作。它们为常见任务提供了分步说明和最佳实践。

可用提示(4)

1. market_scan -市场分析工作流程

指导您浏览观察名单,寻找交易机会。

参数:

  • watchlist_id -要扫描的监视列表(留空先列出监视列表)
  • timeframe -价格分辨率:分钟、分钟-5、小时、天(默认值:小时)
  • lookback_periods -要获取的蜡烛数:1-1000(默认值:24)

工作流程:

  1. 获取观察名单市场
  2. 获取每个市场的价格数据
  3. 技术分析(趋势、支撑/阻力、模式)
  4. 可选情绪检查
  5. 生成商机摘要

示例用法:

  • “使用market_scan提示分析我的观察名单”
  • “扫描我的市场以查看交易设置”

2. trade_proposal -贸易计划工作流程

指导您通过适当的风险管理创建交易提案。

参数:

  • epic -交易市场(必填,如银、金)
  • direction -买入或卖出(默认:买入)
  • thesis -您的交易推理(可选)
  • risk_percent -风险占余额的百分比(默认值:1.0%)

工作流程:

  1. 获取市场详细信息和交易规则
  2. 根据风险百分比计算头寸大小
  3. 定义止损和止盈水平
  4. 预览交易(仅验证-不执行)
  5. 返回潜在执行的preview_id

示例用法:

  • “为SILVER创建交易提案”
  • “建议以2%的风险进行黄金多头交易”

安全: 此提示不会执行交易,它只会创建预览。

3. execute_trade -交易执行工作流程

指导您安全地执行预览交易。

参数:

  • preview_id -从trade_posal预览ID(必填)

工作流程:

  1. 验证是否提供了preview_id并且有效
  2. 重新检查所有风险控制
  3. 与经纪人执行头寸
  4. 投票确认(接受/拒绝)
  5. 报告最终状态

示例用法:

  • “执行我刚才预览的交易”
  • “使用预览ID abc-123进行交易”

安全:

  • 需要CAP_ALLOW_RADING=true
  • 需要史诗般的对抗
  • 预览不得过期(2分钟TTL)
  • ⚠️ 这将带来真正的交易

4. position_review -投资组合分析工作流程

指导您分析未结头寸和订单。

参数: 无(分析所有当前职位)

工作流程:

  1. 获取所有空缺职位
  2. 获取所有工作订单
  3. 计算损益、风险和敞口指标
  4. 识别集中度和相关性风险
  5. 建议潜在的调整(不执行)

示例用法:

  • “查看我目前的职位”
  • “分析我的投资组合风险”

安全: 这是一个只读工作流,不执行任何交易。

如何使用提示

在Claude Desktop或其他MCP客户端中,提示显示为可用的交互模式。你可以在对话中自然地调用它们:

User: "I want to scan my watchlist for opportunities"
Claude: [Invokes market_scan prompt, guides through the workflow]

User: "Create a trade plan for SILVER"
Claude: [Invokes trade_proposal prompt, designs trade with risk management]

User: "Execute that trade"
Claude: [Invokes execute_trade prompt, submits to broker]

User: "Show me my open positions"
Claude: [Invokes position_review prompt, analyzes portfolio]

提示提供结构化的指导,同时在整个工作流程中保持安全控制。

MCP资源(只读数据)

MCP资源通过基于URI的资源提供对服务器状态和配置的只读访问。与执行操作的工具不同,资源公开了客户端可以读取和监视的数据。

可用资源

1. cap://status -服务器状态

实时服务器和会话信息。

退货:JSON,包含服务器运行状况、会话状态、身份验证状态、速率限制

示例:

{
  "server": {
    "name": "Capital.com MCP Server",
    "version": "0.1.0",
    "trading_enabled": true
  },
  "session": {
    "is_logged_in": true,
    "account_id": "ABC123",
    "last_activity": "2026-01-16T10:30:00"
  },
  "risk": {
    "trading_enabled": true,
    "allowed_epics": ["GOLD", "SILVER"],
    "allowlist_mode": "SPECIFIC"
  },
  "rate_limits": {
    "requests_per_second": "10",
    "note": "Capital.com enforces 10 req/s limit"
  }
}

用例:监视服务器运行状况,检查会话状态,调试身份验证问题

______________________________________________________________________

2. cap://risk-policy -风险政策

全面的风险管理配置和安全控制。

退货:具有所有验证层、安全功能和交易限制的JSON

示例:

{
  "trading_enabled": true,
  "two_phase_execution": true,
  "description": "All trades require preview → explicit execution",
  "allowlist": {
    "mode": "SPECIFIC",
    "epics": ["GOLD", "SILVER"],
    "note": "Only markets on this list can be traded (ALL = wildcard)"
  },
  "validation_layers": [
    "1. Trading enabled check (TRADING_ENABLED env var)",
    "2. Epic allowlist check (must be in ALLOWED_EPICS)",
    "... 10 total layers ..."
  ],
  "safety_features": {
    "preview_required": true,
    "deal_reference_matching": true,
    "authentication_required": true,
    "rate_limiting": true,
    "input_validation": true
  }
}

用例:了解主动安全控制、审计风险配置、合规文件

______________________________________________________________________

3. cap://allowed-epics -交易许可列表

当前交易满列表配置显示允许的市场。

退货:JSON,具有满列表模式、允许的epics和配置说明

示例:

{
  "mode": "SPECIFIC",
  "allowed_epics": ["GOLD", "SILVER", "BTCUSD"],
  "count": 3,
  "trading_enabled": true,
  "description": "Restricted mode: 3 specific markets allowed",
  "configuration": {
    "env_var": "ALLOWED_EPICS",
    "example": "ALLOWED_EPICS=GOLD,SILVER,BTCUSD",
    "wildcard": "ALLOWED_EPICS=ALL (allows all markets)"
  }
}

用例:检查哪些市场是可交易的,验证所有配置

______________________________________________________________________

4. cap://market-cache/{epic} -市场详情(动态)

特定史诗的缓存市场详细信息(从经纪商实时获取)。

参数:

  • epic -市场标识符(例如,“GOLD”、“SILVER”、“CS.D.EUR/USD.TODAY.IP”)

退货:JSON,包含全面的市场信息

认证:必填

示例: cap://market-cache/GOLD

{
  "epic": "GOLD",
  "instrument_name": "Spot Gold",
  "instrument_type": "COMMODITIES",
  "currency": "USD",
  "snapshot": {
    "market_status": "TRADEABLE",
    "bid": 2050.50,
    "offer": 2050.75,
    "update_time": "2026-01-16T10:30:00"
  },
  "dealing": {
    "min_size": 0.1,
    "max_size": 100.0,
    "min_step": 0.1,
    "min_stop_distance": 5.0
  },
  "margin": {
    "factor": 5.0,
    "unit": "PERCENTAGE"
  },
  "opening_hours": {...},
  "cached_at": "2026-01-16T10:30:00"
}

用例:获取市场详细信息,检查交易规则,分析保证金要求

______________________________________________________________________

如何使用资源

在Claude Desktop或其他MCP客户端中,可以通过URI访问资源:

User: "Show me the server status"
Claude: [Reads cap://status resource, displays server health]

User: "What's the risk policy?"
Claude: [Reads cap://risk-policy resource, explains safety controls]

User: "Which markets can I trade?"
Claude: [Reads cap://allowed-epics resource, lists permitted epics]

User: "Show all my watchlists"
Claude: [Calls cap_watchlists_list tool, displays watchlist data]

User: "Get details for GOLD market"
Claude: [Reads cap://market-cache/GOLD resource, shows market info]

资源提供了一种无需运行工具即可检查服务器状态和配置的便捷方法。对于监视列表数据,请使用 cap_watchlists_listcap_watchlists_get 工具。

安全模型

两阶段执行

所有副作用操作都使用严格的预览→ 执行流程:

  1. 预览:根据经纪人规则+当地风险政策验证交易

- 退货 preview_id 具有标准化请求+风险检查 - 无副作用,只读验证

  1. 执行:使用提交交易 preview_id

- 重新运行关键检查 - 需要 confirm=true 如果 CAP_REQUIRE_EXPLICIT_CONFIRM=true - 民意调查经纪人确认 - 递增每日订单计数器

风险护栏

  • 允许列表:只有EPIC CAP_ALLOWED_EPICS 可以交易
  • 大小限制:强制执行最大头寸/订单大小
  • 位置限制:任何时候的最大未平仓头寸
  • 每日限额:每天最大订单数
  • 尺寸标准化:四舍五入到经纪人最小/最大/增量
  • 干运行模式:启用时阻止所有执行

发展

运行测试

# Run all tests
pytest

# Run with coverage report
pytest --cov=capital_mcp --cov-report=html

# Run specific test file
pytest tests/test_mcp_registration.py

# Run in verbose mode
pytest -v

当前测试覆盖率:

  • 21项测试(全部通过)
  • MCP注册验证(36个工具、4个资源、7个提示)
  • 导入和模块结构测试
  • 提示模式验证
  • WebSocket客户端和模型测试

代码质量

# Format
black capital_mcp/

# Lint
ruff check capital_mcp/

# Type check
mypy capital_mcp/

文档

  • 使用指南: 用法.md -带示例的综合使用指南
  • 实施总结: 实施\_ SUMMARY.md -项目概况
  • Capital.com API参考: https://open-api.capital.com/
  • Capital.com API邮差系列: https://github.com/capital-com-sv/capital-api-postman

许可证

麻省理工学院

免责声明

该软件“按原样”提供,用于教育和工程目的。交易金融工具涉及损失风险。作者对使用本软件造成的任何经济损失不承担任何责任。在考虑实时交易之前,务必对模拟账户进行彻底测试。

目录标签

目录标签

金融交易风险管理PythonClaude教育工具本地部署API集成自动化交易

支持客户端

Claude DesktopClaudeCursorWindsurf

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

token

运行时(runtime,运行环境)

Python

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiotoken部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP