Investec MCP: Banking API for AI Agents

Investec MCP：AI エージェント向け銀行 API

Model Context Protocol (MCP) サーバーの実装です。Investec Open Banking API と連携し、AI エージェントが銀行情報にアクセスして取引を実行できるようにします。

概要

このプロジェクトは、AI エージェントが Investec Open Banking API を利用できるようにする MCP サーバーを提供します。Anthropic が示す MCP サーバー構築のベストプラクティスに従っており、Claude など、MCP 対応クライアントとシームレスに連携できます。

機能

このサーバーは、Investec Open Banking API に基づく包括的な銀行関連ツールを提供します。

口座情報

1. get_accounts：認証済みユーザーのすべての口座を取得します
2. get_account_balance：特定の口座の残高を取得します
3. get_account_transactions：フィルタリングオプションを指定して、特定の口座の取引を取得します
4. get_pending_transactions：特定の口座の保留中の取引を取得します

プロフィール管理

5. get_profiles：ユーザーが同意したすべてのプロフィールを取得します
6. get_profile_accounts：特定のプロフィールの口座を取得します
7. get_profile_beneficiaries：特定のプロフィールと口座の受取人を取得します
8. get_authorisation_setup_details：承認が必要な支払いの認証設定の詳細を取得します

受取人管理

9. get_beneficiaries：保存済みの受取人をすべて取得します
10. get_beneficiary_categories：受取人のカテゴリーをすべて取得します

送金と支払い

11. transfer_money：自分の口座間で送金します（便利なメソッド）
12. transfer_multiple：一括で1つまたは複数の口座に資金を送金します
13. pay_beneficiary：保存済みの受取人に支払います（便利なメソッド）
14. pay_multiple：一括で複数の受取人に支払います

書類管理

15. get_documents：期間を指定して、口座の書類一覧を取得します
16. get_document：種類と日付を指定して、特定の書類を取得します

前提条件

• Python 3.12+
• API 認証情報を持つ Investec Developer アカウント
• MCP サーバーをコンテナとして実行する場合は Docker（推奨）

インストール

uv を使用する場合

1. このリポジトリをクローンします。

   git clone https://github.com/yourusername/investec-mcp.git
   cd investec-mcp
   

2. 依存関係をインストールします。

   uv pip install -e .
   

3. .env.example を基に .env ファイルを作成します。

   cp .env.example .env
   

4. Investec API 認証情報を使って、.env ファイルの環境変数を設定します

Docker を使用する場合（推奨）

1. Docker イメージをビルドします。

   docker build -t investec/mcp --build-arg PORT=8050 .
   

2. .env.example を基に .env ファイルを作成し、環境変数を設定します

設定

以下の環境変数を .env ファイルで設定できます。

変数	説明	例
TRANSPORT	トランスポートプロトコル（sse または stdio）	sse
HOST	SSE トランスポート使用時のバインド先ホスト	0.0.0.0
PORT	SSE トランスポート使用時の待ち受けポート	8050
INVESTEC_CLIENT_ID	Investec Developer Portal のクライアント ID	your-client-id
INVESTEC_CLIENT_SECRET	Investec Developer Portal のクライアントシークレット	your-client-secret
INVESTEC_API_KEY	Investec Developer Portal の API キー	your-api-key

サーバーの実行

uv を使用する場合

SSE トランスポート

# Set TRANSPORT=sse in .env then:
uv run python src/main.py

MCP サーバーは、接続可能な API エンドポイントとして実行されます。

Stdio トランスポート

stdio を使用すると、MCP クライアント自体が MCP サーバーを起動できます。

Docker を使用する場合

SSE トランスポート

docker run --env-file .env -p 8050:8050 investec/mcp

MCP サーバーは、接続可能なコンテナ内の API エンドポイントとして実行されます。

Stdio トランスポート

stdio を使用すると、MCP クライアント自体が MCP サーバーのコンテナを起動できます。

MCP クライアントとの統合

SSE の設定

SSE トランスポートでサーバーを起動したら、次の設定を使用して接続できます。

{
  "mcpServers": {
    "investec": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

Windsurf ユーザーへの注意：設定では url の代わりに serverUrl を使用してください。

{
  "mcpServers": {
    "investec": {
      "transport": "sse",
      "serverUrl": "http://localhost:8050/sse"
    }
  }
}

デフォルトの 8050 以外のポートを使用する場合は、ポート番号を更新してください。

Python の Stdio 設定

このサーバーを Claude Desktop、Windsurf、またはその他の MCP クライアントの MCP 設定に追加してください。

{
  "mcpServers": {
    "investec": {
      "command": "path/to/python",
      "args": ["path/to/investec-mcp/src/main.py"],
      "env": {
        "TRANSPORT": "stdio",
        "INVESTEC_CLIENT_ID": "your-client-id",
        "INVESTEC_CLIENT_SECRET": "your-client-secret",
        "INVESTEC_API_KEY": "your-api-key"
      }
    }
  }
}

Docker の Stdio 設定

{
  "mcpServers": {
    "investec": {
      "command": "docker",
      "args": ["run", "--rm", "-i", 
               "-e", "TRANSPORT", 
               "-e", "INVESTEC_CLIENT_ID", 
               "-e", "INVESTEC_CLIENT_SECRET", 
               "-e", "INVESTEC_API_KEY", 
               "investec/mcp"],
      "env": {
        "TRANSPORT": "stdio",
        "INVESTEC_CLIENT_ID": "your-client-id",
        "INVESTEC_CLIENT_SECRET": "your-client-secret",
        "INVESTEC_API_KEY": "your-api-key"
      }
    }
  }
}

セキュリティに関する考慮事項

この MCP サーバーでは、機密性の高い銀行の認証情報が必要です。必ず次の点を守ってください。

1. .env ファイルを安全に保管し、バージョン管理に絶対にコミットしないでください。
2. コンテナイメージをビルドして配布する場合は、安全でプライベートな Docker レジストリを使用してください。
3. サーバーは、安全で信頼できるネットワーク上でのみ実行してください。
4. リクエストのレート制限など、追加のセキュリティ対策の実装を検討してください。

サーバーの拡張

機能を追加するには、次の手順を実行してください。

1. src/utils.py の InvestecClient クラスにメソッドを追加し、目的の Investec API エンドポイントとやり取りできるようにします。
2. src/tools/ ディレクトリ内の該当する Python ファイル（例：アカウント関連のツールの場合は src/tools/accounts.py）に、新しいツール関数を作成します。これらの関数には @mcp.tool() デコレーターを使用してください。
3. 新しいツール関数を src/main.py にインポートして登録します。