Servidor MCP de Wise

Un servidor MCP (Machine Communication Protocol) que actúa como puerta de enlace para la API de Wise, proporcionando un acceso simplificado a la funcionalidad de destinatarios de Wise.

Características

• Lista todos los destinatarios de tu cuenta de Wise a través de un recurso MCP sencillo

• Gestiona automáticamente la autenticación y la selección de perfil

• Utiliza la API Sandbox de Wise para desarrollo y pruebas

• Disponible como imagen de Docker para una fácil integración

Requisitos

• Python 3.12 o superior (solo si se instala directamente)

• Gestor de paquetes uv (solo si se instala directamente)

• Token de la API de Wise

• Docker (si se utiliza la imagen de Docker)

Obtener un token de API

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

Crea un nuevo token aquí.

Instalación

Opción 1: Instalación directa

1. Clona este repositorio:

   git clone repo-url
   cd jc-wise-mcp

2. Configura el entorno:

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

3. Instala las dependencias con uv:

   uv venv
   uv pip install -e .

Opción 2: Usando Docker

Puedes construir una imagen de Docker:

docker build -t mcp-wise .

Y añadirla a Claude Code incluyéndola en tu .mcp.json

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

Asegúrate de reemplazar your_api_token_here con tu token real de la API de Wise.

Asegúrate también de actualizar tu archivo .mcp.json para que coincida con el modo seleccionado. Proporcionamos archivos de plantilla que puedes utilizar:

1. Para el modo stdio (predeterminado):

   cp .mcp.json.stdio .mcp.json

2. Para el modo HTTP:

   cp .mcp.json.http .mcp.json

Estos archivos de plantilla contienen la configuración adecuada para cada modo.

Recursos MCP disponibles

El servidor proporciona los siguientes recursos MCP:

list_recipients

Devuelve una lista de todos los destinatarios de tu cuenta de Wise.

Parámetros:

• profile_type: El tipo de perfil para el que listar los destinatarios. Uno de [personal, business]. Predeterminado: "personal"

• currency: Opcional. Filtra los destinatarios por código de divisa (p. ej., 'EUR', 'USD')

get_recipient_requirements

Obtiene los requisitos del destinatario para crear uno nuevo. Si se proporcionan detalles de la cuenta, valida los detalles de la cuenta frente a los requisitos.

Parámetros:

• source_currency: El código de divisa de origen (p. ej., 'USD')

• target_currency: El código de divisa de destino (p. ej., 'EUR')

• source_amount: El importe en la divisa de origen

• profile_type: El tipo de perfil a utilizar. Uno de [personal, business]. Predeterminado: "personal"

• account: Opcional. Los detalles de la cuenta del destinatario para validar frente a los requisitos. Si no se proporciona, devuelve los requisitos iniciales de la cuenta.

create_recipient

Crea un nuevo destinatario con los detalles de cuenta proporcionados.

Parámetros:

• profile_type: El tipo de perfil a utilizar. Uno de [personal, business]. Predeterminado: "personal"

• account: Los detalles de la cuenta del destinatario que cumplen con los requisitos de la API de Wise. Esto debe incluir:

  • accountHolderName: Nombre del titular de la cuenta

  • currency: Código de divisa de destino (p. ej., 'EUR')

  • type: Tipo de cuenta (p. ej., 'iban', 'sort_code', etc.)

  • details: Objeto que contiene detalles específicos de la cuenta (varía según la divisa y el país)

send_money

Envía dinero a un destinatario utilizando la API de Wise.

Parámetros:

• profile_type: El tipo de perfil a utilizar (personal o business)

• source_currency: Código de divisa de origen (p. ej., 'USD')

• source_amount: Importe en la divisa de origen a enviar

• recipient_id: El ID del destinatario al que enviar el dinero

• payment_reference: Opcional. Mensaje de referencia para la transferencia (predeterminado a "money")

• source_of_funds: Opcional. Origen de los fondos (p. ej., "salary", "savings")

Configuración

La configuración se realiza a través de variables de entorno, que pueden establecerse en el archivo .env:

• WISE_API_TOKEN: Tu token de la API de Wise (obligatorio)

• WISE_IS_SANDBOX: Establecer en true para usar la API Sandbox de Wise (predeterminado: false)

• MODE: Modo de transporte del servidor MCP, ya sea "http" o "stdio" (predeterminado: stdio)

Desarrollo

Estructura del proyecto

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

Añadir nuevas características

Para añadir nuevas características:

1. Añade nuevos métodos de cliente de API en src/wise_mcp/api/wise_client.py

2. Crea nuevos recursos en src/wise_mcp/resources/

3. Importa y registra los nuevos recursos en src/wise_mcp/app.py

Contribución

¡Las contribuciones son bienvenidas! Por favor, siéntete libre de enviar un Pull Request.

Licencia

MIT