Wise MCP-Server

Ein MCP-Server (Machine Communication Protocol), der als Gateway für die Wise-API dient und einen vereinfachten Zugriff auf die Empfängerfunktionen von Wise bietet.

Funktionen

• Auflisten aller Empfänger aus Ihrem Wise-Konto über eine einfache MCP-Ressource

• Automatische Handhabung von Authentifizierung und Profilauswahl

• Nutzt die Wise Sandbox-API für Entwicklung und Tests

• Verfügbar als Docker-Image für eine einfache Integration

Anforderungen

• Python 3.12 oder höher (nur bei direkter Installation)

• uv Paketmanager (nur bei direkter Installation)

• Wise API-Token

• Docker (bei Verwendung des Docker-Images)

API-Token abrufen

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

Erstellen Sie hier ein neues Token.

Installation

Option 1: Direkte Installation

1. Klonen Sie dieses Repository:

   git clone repo-url
   cd jc-wise-mcp

2. Richten Sie die Umgebung ein:

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

3. Installieren Sie die Abhängigkeiten mit uv:

   uv venv
   uv pip install -e .

Option 2: Verwendung von Docker

Sie können ein Docker-Image erstellen:

docker build -t mcp-wise .

Fügen Sie es zu Claude Code hinzu, indem Sie es in Ihre .mcp.json eintragen:

{
  "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"
      ]
    }
  }
}

Stellen Sie sicher, dass Sie your_api_token_here durch Ihr tatsächliches Wise API-Token ersetzen.

Stellen Sie außerdem sicher, dass Sie Ihre .mcp.json-Datei an den von Ihnen gewählten Modus anpassen. Wir stellen Vorlagendateien bereit, die Sie verwenden können:

1. Für den stdio-Modus (Standard):

   cp .mcp.json.stdio .mcp.json

2. Für den HTTP-Modus:

   cp .mcp.json.http .mcp.json

Diese Vorlagendateien enthalten die entsprechende Konfiguration für jeden Modus.

Verfügbare MCP-Ressourcen

Der Server stellt die folgenden MCP-Ressourcen bereit:

list_recipients

Gibt eine Liste aller Empfänger aus Ihrem Wise-Konto zurück.

Parameter:

• profile_type: Der Profiltyp, für den Empfänger aufgelistet werden sollen. Einer aus [personal, business]. Standard: "personal"

• currency: Optional. Filtert Empfänger nach Währungscode (z. B. 'EUR', 'USD')

get_recipient_requirements

Ruft die Empfängeranforderungen für das Erstellen eines neuen Empfängers ab. Wenn Kontodetails bereitgestellt werden, werden diese anhand der Anforderungen validiert.

Parameter:

• source_currency: Der Quellwährungscode (z. B. 'USD')

• target_currency: Der Zielwährungscode (z. B. 'EUR')

• source_amount: Der Betrag in der Quellwährung

• profile_type: Der zu verwendende Profiltyp. Einer aus [personal, business]. Standard: "personal"

• account: Optional. Die Empfängerkontodetails, die gegen die Anforderungen validiert werden sollen. Wenn nicht angegeben, werden die anfänglichen Kontonanforderungen zurückgegeben.

create_recipient

Erstellt einen neuen Empfänger mit den bereitgestellten Kontodetails.

Parameter:

• profile_type: Der zu verwendende Profiltyp. Einer aus [personal, business]. Standard: "personal"

• account: Die Empfängerkontodetails, die den Anforderungen der Wise-API entsprechen. Dies sollte beinhalten:

  • accountHolderName: Name des Kontoinhabers

  • currency: Zielwährungscode (z. B. 'EUR')

  • type: Kontotyp (z. B. 'iban', 'sort_code' usw.)

  • details: Objekt mit kontospezifischen Details (variiert je nach Währung und Land)

send_money

Sendet Geld an einen Empfänger über die Wise-API.

Parameter:

• profile_type: Der zu verwendende Profiltyp (personal oder business)

• source_currency: Quellwährungscode (z. B. 'USD')

• source_amount: Zu sendender Betrag in der Quellwährung

• recipient_id: Die ID des Empfängers, an den das Geld gesendet werden soll

• payment_reference: Optional. Referenznachricht für die Überweisung (Standard: "money")

• source_of_funds: Optional. Herkunft der Gelder (z. B. "salary", "savings")

Konfiguration

Die Konfiguration erfolgt über Umgebungsvariablen, die in der .env-Datei festgelegt werden können:

• WISE_API_TOKEN: Ihr Wise API-Token (erforderlich)

• WISE_IS_SANDBOX: Auf true setzen, um die Wise Sandbox-API zu verwenden (Standard: false)

• MODE: MCP-Server-Transportmodus, entweder "http" oder "stdio" (Standard: stdio)

Entwicklung

Projektstruktur

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

Neue Funktionen hinzufügen

Um neue Funktionen hinzuzufügen:

1. Fügen Sie neue API-Client-Methoden in src/wise_mcp/api/wise_client.py hinzu

2. Erstellen Sie neue Ressourcen in src/wise_mcp/resources/

3. Importieren und registrieren Sie die neuen Ressourcen in src/wise_mcp/app.py

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.

Lizenz

MIT