MCP Servers Collection

MCP サーバーコレクション

このリポジトリには、Amazon Q、Claude Desktop、および MCP プロトコルに対応したその他の LLM で使用できる、Model Context Protocol（MCP） サーバーのコレクションが含まれています。

利用可能な MCP サーバー

• Capital.com MCP サーバー：Capital.com の取引 API を、取引操作用の MCP ツールとして提供します

  • マーケットを検索します（例：EURUSD、AAPL）
  • アカウント情報とポジションを取得します
  • 取引ポジションを作成・管理します
  • ウォッチリストにアクセスします

• eToro MCP サーバー：eToro の取引 API を、取引操作用の MCP ツールとして提供します

  • 名前、シンボル、またはカテゴリーで金融商品を検索します
  • アカウント情報（残高、純資産、証拠金）を取得します
  • 保有中の取引ポジションを取得・管理します
  • レバレッジ、ストップロス、テイクプロフィットを設定してポジションを作成します
  • 金融商品のリアルタイムの買値・売値を取得します
  • 金融商品の詳細なメタデータ（取引時間、スプレッド、制限）にアクセスします

MCP とは？

Model Context Protocol（MCP） は、アプリケーションが LLM にコンテキストを提供する方法を標準化するオープンプロトコルです。MCP により、システムと、LLM の機能を拡張するためのツールやリソースを提供するローカルで実行中の 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 で、「設定」>「開発者」セクションに移動し、「設定を編集」をクリックします

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 サーバーは、src/ ディレクトリ内の個別の Python パッケージとして構成されています：

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 ファイルをご覧ください。