Wise MCP Server

MCP-сервер (Machine Communication Protocol), выступающий в качестве шлюза для API Wise и предоставляющий упрощенный доступ к функциям получателей Wise.

Возможности

• Просмотр всех получателей из вашей учетной записи Wise через простой MCP-ресурс

• Автоматическая обработка аутентификации и выбора профиля

• Использование API Wise Sandbox для разработки и тестирования

• Доступен в виде Docker-образа для легкой интеграции

Требования

• Python 3.12 или выше (только при прямой установке)

• Менеджер пакетов uv (только при прямой установке)

• Токен API Wise

• 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 .

И добавьте его в Claude Code, внеся изменения в ваш файл .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"
      ]
    }
  }
}

Не забудьте заменить your_api_token_here на ваш реальный API-токен Wise.

Также убедитесь, что обновили файл .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: Данные счета получателя, соответствующие требованиям API Wise. Должны включать:

  • accountHolderName: Имя владельца счета

  • currency: Код целевой валюты (например, 'EUR')

  • type: Тип счета (например, 'iban', 'sort_code' и т.д.)

  • details: Объект, содержащий специфические для счета данные (зависят от валюты и страны)

send_money

Отправляет деньги получателю с использованием API Wise.

Параметры:

• profile_type: Тип используемого профиля (personal или business)

• source_currency: Код исходной валюты (например, 'USD')

• source_amount: Сумма в исходной валюте для отправки

• recipient_id: ID получателя, которому отправляются деньги

• payment_reference: Необязательно. Справочное сообщение для перевода (по умолчанию "money")

• source_of_funds: Необязательно. Источник средств (например, "salary", "savings")

Конфигурация

Конфигурация осуществляется через переменные окружения, которые можно задать в файле .env:

• WISE_API_TOKEN: Ваш API-токен Wise (обязательно)

• WISE_IS_SANDBOX: Установите в true для использования API Wise Sandbox (по умолчанию: 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. Добавьте новые методы API-клиента в src/wise_mcp/api/wise_client.py

2. Создайте новые ресурсы в src/wise_mcp/resources/

3. Импортируйте и зарегистрируйте новые ресурсы в src/wise_mcp/app.py

Участие в разработке

Мы приветствуем ваш вклад! Пожалуйста, не стесняйтесь отправлять Pull Request.

Лицензия

MIT