MCP Servers Collection

MCP 服务集合

此代码仓库包含一组 Model Context Protocol (MCP) 服务，可与 Amazon Q、Claude Desktop 以及其他支持 MCP 协议的大模型配合使用。

可用的 MCP 服务

• Capital.com MCP 服务：将 Capital.com 交易 API 封装为 MCP 工具，用于交易操作

  • 搜索市场（例如 EURUSD、AAPL）
  • 获取账户信息和持仓
  • 创建和管理交易持仓
  • 访问自选列表

• eToro MCP 服务：将 eToro 交易 API 封装为 MCP 工具，用于交易操作

  • 按名称、代码或类别搜索交易品种
  • 获取账户信息（余额、净值、保证金）
  • 获取和管理未平仓交易
  • 创建带杠杆、止损和止盈的持仓
  • 获取交易品种的实时买入价/卖出价
  • 访问详细的交易品种元数据（交易时间、点差、限额）

什么是 MCP？

Model Context Protocol (MCP) 是一种开放协议，用于规范应用程序向大模型提供上下文的方式。MCP 支持系统与本地运行的 MCP 服务之间进行通信，这些服务提供额外的工具和资源，以扩展大模型的能力。

先决条件

请确保系统已安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

与 Amazon Q 配合使用

1. 在 Amazon Q 配置目录（~/.aws/amazonq/mcp.json）中创建 mcp.json 配置文件：

   {
     "mcpServers": {
       "capital-com-mcp-server": {
         "command": "uvx",
         "args": ["capital-com-mcp-server"],
         "env": {
           "CAPITAL_BASE_URL": "https://demo-api-capital.backend-capital.com",
           "CAPITAL_API_KEY": "your_api_key_here",
           "CAPITAL_PASSWORD": "your_password_here",
           "CAPITAL_IDENTIFIER": "[email protected]",
           "FASTMCP_LOG_LEVEL": "ERROR"
         }
       },
       "etoro-mcp-server": {
         "command": "uvx",
         "args": ["etoro-mcp-server"],
         "env": {
           "ETORO_API_KEY": "your_public_app_key_here",
           "ETORO_USER_KEY": "your_user_key_here",
           "ETORO_ACCOUNT_TYPE": "demo",
           "FASTMCP_LOG_LEVEL": "ERROR"
         }
       }
     }
   }
   

2. 使用以下命令运行 Amazon Q：

   q chat
   

3. Amazon Q 将自动启动 MCP 服务并与之连接。

与 Claude Desktop 配合使用

1. 在 Claude Desktop 中，前往 Settings > Developer 部分，然后点击 “Edit Config”。

2. 这将打开配置文件。将以下内容添加到 JSON 中：

   {
     "mcpServers": {
       "capital-com-mcp-server": {
         "command": "uvx",
         "args": ["capital-com-mcp-server"],
         "env": {
           "CAPITAL_BASE_URL": "https://demo-api-capital.backend-capital.com",
           "CAPITAL_API_KEY": "your_api_key_here",
           "CAPITAL_PASSWORD": "your_password_here",
           "CAPITAL_IDENTIFIER": "[email protected]",
           "FASTMCP_LOG_LEVEL": "ERROR"
         }
       },
       "etoro-mcp-server": {
         "command": "uvx",
         "args": ["etoro-mcp-server"],
         "env": {
           "ETORO_API_KEY": "your_public_app_key_here",
           "ETORO_USER_KEY": "your_user_key_here",
           "ETORO_ACCOUNT_TYPE": "demo",
           "FASTMCP_LOG_LEVEL": "ERROR"
         }
       }
     }
   }
   

3. 保存文件并重启 Claude Desktop。

对话示例

Capital.com

You: Search for Apple stock on Capital.com

AI: I'll search for Apple stock on Capital.com for you.

[Uses capital-com-mcp-server___search_markets tool]

I found Apple Inc. (AAPL) on Capital.com. Here are the details:
- Epic: AAPL
- Market name: Apple Inc.
- Current bid price: $184.25
- Current ask price: $184.30
- Market status: OPEN

Would you like me to get more information about this stock or perform any trading operations?

eToro

You: Search for Apple stock on eToro

AI: I'll search for Apple stock on eToro for you.

[Uses search_instruments tool with search_term="Apple"]

I found Apple Inc. on eToro. Here are the details:
- Instrument ID: 1001
- Name: Apple Inc.
- Symbol: AAPL
- Category: Stocks
- Current price: $184.25
- Market status: OPEN

Note: The instrument ID (1001) is what you'll need for trading operations.

You: Buy $1000 worth of Bitcoin with 2x leverage and set a stop loss at $60,000

AI: I'll create a Bitcoin position with your specified parameters.

[Uses search_instruments to find Bitcoin instrument ID, then create_position]

Successfully created a BUY position for Bitcoin:
- Position ID: pos_abc123
- Instrument ID: 2045 (Bitcoin)
- Amount: $1,000
- Leverage: 2x
- Stop loss: $60,000
- Status: OPEN
- Current P&L: $0.00

The position is now active and being monitored.

代码仓库结构

每个 MCP 服务都作为单独的 Python 包，存放在 src/ 目录下：

mcp-servers/
├── README.md
└── src/
    ├── capital_com_mcp_server/
    │   ├── README.md
    │   ├── pyproject.toml
    │   ├── capital_com_mcp_server/
    │   │   ├── __init__.py
    │   │   ├── capital_mcp_server.py
    │   │   └── capital_client.py
    │   └── ...
    └── etoro_mcp_server/
        ├── README.md
        ├── pyproject.toml
        ├── etoro_mcp_server/
        │   ├── __init__.py
        │   ├── etoro_mcp_server.py
        │   └── etoro_client.py
        └── ...

开发

要向此集合添加新的 MCP 服务：

1. 在 src/ 下创建一个以服务名称命名的新目录
2. 添加实现 MCP 服务所需的文件
3. 在服务目录中加入 pyproject.toml 和 setup.py
4. 添加包含使用说明的 README.md

发布

每个 MCP 服务都可以单独发布到 PyPI：

cd src/your_mcp_server
uv build
uv pip publish

GitHub Actions

此代码仓库使用 GitHub Actions，在创建新版本时自动构建并发布软件包到 PyPI。工作流配置为采用矩阵策略，以便分别构建和发布每个软件包。

要向发布工作流添加新软件包，请更新 .github/workflows/python-publish.yml 中的矩阵：

strategy:
  matrix:
    package: [capital_com_mcp_server, etoro_mcp_server]

资源

• MCP 文档
• Amazon Q 文档
• Claude Desktop 文档

许可证

此项目采用 MIT License 授权，详情请参阅 LICENSE 文件。