Wise MCPサーバー

Wise APIのゲートウェイとして機能し、Wiseの受取人機能への簡素化されたアクセスを提供するMCP（Machine Communication Protocol）サーバーです。

機能

• シンプルなMCPリソースを介して、Wiseアカウントのすべての受取人を一覧表示

• 認証とプロファイルの選択を自動的に処理

• 開発およびテスト用にWiseサンドボックスAPIを使用

• 統合が容易なDockerイメージとして利用可能

要件

• Python 3.12以上（直接インストールする場合のみ）

• uvパッケージマネージャー（直接インストールする場合のみ）

• Wise APIトークン

• Docker（Dockerイメージを使用する場合）

APIトークンの取得

https://wise.com/your-account/integrations-and-tools/api-tokens

こちらで新しいトークンを作成してください。

インストール

オプション1: 直接インストール

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

   git clone repo-url
   cd jc-wise-mcp

2. 環境をセットアップします:

   cp .env.example .env
   # Edit .env to add your Wise API token

3. uvで依存関係をインストールします:

   uv venv
   uv pip install -e .

オプション2: Dockerの使用

Dockerイメージをビルドできます:

docker build -t mcp-wise .

そして、.mcp.jsonに追加してClaude Codeに追加します

{
  "mcpServers": {
    "mcp-wise": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--init",
        "-e", "WISE_API_TOKEN=your_api_token_here",
        "-e", "WISE_IS_SANDBOX=true",
        "mcp-wise:latest"
      ]
    }
  }
}

your_api_token_hereを実際のWise APIトークンに置き換えてください。

また、選択したモードに合わせて.mcp.jsonファイルを更新してください。使用可能なテンプレートファイルを提供しています:

1. stdioモード（デフォルト）の場合:

   cp .mcp.json.stdio .mcp.json

2. HTTPモードの場合:

   cp .mcp.json.http .mcp.json

これらのテンプレートファイルには、各モードに適した設定が含まれています。

利用可能なMCPリソース

このサーバーは以下のMCPリソースを提供します:

list_recipients

Wiseアカウントのすべての受取人のリストを返します。

パラメータ:

• profile_type: 受取人を一覧表示するプロファイルのタイプ。[personal, business]のいずれか。デフォルト: "personal"

• currency: オプション。通貨コードで受取人をフィルタリングします（例: 'EUR', 'USD'）

get_recipient_requirements

新しい受取人を作成するための要件を取得します。口座詳細が提供されている場合は、要件に対して口座詳細を検証します。

パラメータ:

• source_currency: 送金元通貨コード（例: 'USD'）

• target_currency: 送金先通貨コード（例: 'EUR'）

• source_amount: 送金元通貨での金額

• profile_type: 使用するプロファイルのタイプ。[personal, business]のいずれか。デフォルト: "personal"

• account: オプション。要件に対して検証する受取人の口座詳細。提供されない場合は、初期の口座要件を返します。

create_recipient

提供された口座詳細を使用して新しい受取人を作成します。

パラメータ:

• profile_type: 使用するプロファイルのタイプ。[personal, business]のいずれか。デフォルト: "personal"

• account: Wise API要件に準拠した受取人の口座詳細。以下を含める必要があります:

  • accountHolderName: 口座名義人

  • currency: 送金先通貨コード（例: 'EUR'）

  • type: 口座タイプ（例: 'iban', 'sort_code'など）

  • details: 口座固有の詳細を含むオブジェクト（通貨や国によって異なります）

send_money

Wise APIを使用して受取人に送金します。

パラメータ:

• profile_type: 使用するプロファイルのタイプ（personalまたはbusiness）

• source_currency: 送金元通貨コード（例: 'USD'）

• source_amount: 送金する送金元通貨での金額

• recipient_id: 送金先の受取人ID

• payment_reference: オプション。送金の参照メッセージ（デフォルトは "money"）

• source_of_funds: オプション。資金源（例: "salary", "savings"）

設定

設定は環境変数を通じて行われ、.envファイルで設定できます:

• WISE_API_TOKEN: Wise APIトークン（必須）

• WISE_IS_SANDBOX: WiseサンドボックスAPIを使用する場合はtrueに設定（デフォルト: false）

• MODE: MCPサーバーのトランスポートモード。「http」または「stdio」（デフォルト: stdio）

開発

プロジェクト構造

wise-mcp/
├── .env                # Environment variables (not in git)
├── .env.example        # Example environment variables
├── pyproject.toml      # Project dependencies and configuration
├── README.md           # This file
└── src/                # Source code
    ├── main.py         # Entry point
    └── wise_mcp/       # Main package
        ├── api/        # API clients
        │   └── wise_client.py # Wise API client
        ├── resources/  # MCP resources
        │   └── recipients.py  # Recipients resource
        └── app.py      # MCP application setup

新機能の追加

新機能を追加するには:

1. src/wise_mcp/api/wise_client.pyに新しいAPIクライアントメソッドを追加します

2. src/wise_mcp/resources/に新しいリソースを作成します

3. src/wise_mcp/app.pyで新しいリソースをインポートして登録します

コントリビューション

コントリビューションを歓迎します！プルリクエストを送信してください。

ライセンス

MIT