Банк MCP

Модель сервера контекстного протокола для Bunq (голландский необанк).

Доступные инструменты

Этот MCP-сервер предоставляет следующие инструменты для взаимодействия с Bunq:

1. bunqAccounts — получите данные о своих счетах Bunq, такие как тип счета, баланс и идентификатор.

2. getTransactions - Просмотр транзакций (платежей) для определенного счета

3. getRequestInquiries — получение запросов на получение денег, отправленных с определенного счета

4. createPaymentRequest - Создайте запрос на оплату для получения денег на свой счет

5. getPaymentAutoAllocates — получение настроек автоматического распределения платежей для учетной записи

6. getTopCounterpartyes — получение списка уникальных контрагентов на основе последних транзакций

7. createDraftPayment — создание черновиков платежей с возможностью планирования (требуется проверка/утверждение в приложении перед выполнением)

8. createPayment - Создание платежей реальными деньгами (переводы происходят немедленно). Доступно только при использовании ключа API (не OAuth).

Доступ к этим инструментам можно получить через любой клиент MCP, подключенный к этому серверу.

Related MCP server: Tinder API MCP Server

Аутентификация

Этот сервер поддерживает два режима аутентификации: OAuth и API Key . Для получения дополнительной информации см. документацию Bunq .

Создание ключа API или клиента OAuth выполняется через приложение Bunq:

1. Нажмите на свое лицо в левом верхнем углу.

2. Нажмите на шестеренку в правом верхнем углу.

3. В разделе «Разработчики» перейдите в раздел «OAuth» или «API-ключи».

4. При использовании OAuth установите следующий URL-адрес перенаправления:

   http://localhost:8788/callback

(При необходимости измените порт.)

При запуске сервера вы можете либо задать переменные окружения BUNQ_CLIENT_ID и BUNQ_CLIENT_SECRET , либо переменную окружения BUNQ_API_KEY . В качестве альтернативы вы можете передать идентификатор клиента и секрет или ключ API в качестве аргументов командной строки: --bunq-client-id <id> --bunq-client-secret <secret> или --bunq-api-key <key> .

Примечание: если вы хотите создавать реальные платежи без чека, вам необходимо использовать ключ API.

Установка и использование

1. Установите инструменты командной строки bunq-mcp и mcp-remote :

npm install -g bunq-mcp mcp-remote

2. В приложении Bunq создайте клиент OAuth или ключ API (см. выше).

3. (Необязательно) Создайте новую пару открытого и закрытого ключей:

bunq-mcp --generate-keys

Обратите внимание, что это предполагает, что openssl установлен и доступен в PATH. Если вы решите пропустить этот шаг, будут использоваться уже существующие ключи в ./src/keys/ . Созданные ключи переопределят уже существующие ключи и будут сохранены в глобальном каталоге node_modules .

4. Запустите MCP-сервер в любом терминале:

bunq-mcp --mcp --bunq-client-id <client-id> --bunq-client-secret <client-secret>

Идентификатор клиента и секрет также можно задать с помощью переменных среды BUNQ_CLIENT_ID и BUNQ_CLIENT_SECRET .

5. В вашем любимом редакторе или другом MCP-клиенте (например, Claude Desktop) добавьте следующее:

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

Опять же, измените порт, если необходимо. mcp-remote используется, поскольку этот пакет использует транспорт SSE, в то время как большинство клиентов его не поддерживают. См. mcp-remote для получения дополнительной информации.

6. Как только сервер MCP будет запущен, mcp-remote должен открыть ваш браузер для запуска потока OAuth.

Теперь вы сможете задать вопрос, например:

• Каков мой текущий баланс Bunq?

• Каковы мои 5 основных контрагентов?

• Какая была моя последняя транзакция?

Поиск неисправностей

• Если возникли какие-либо проблемы с потоком OAuth, вы можете попробовать удалить каталог, созданный mcp-remote в вашем домашнем каталоге: rm -rf ~/.mcp-auth .

CLI

Usage: bunq-mcp [options]

Options:
  --help              Show help
  --version           Show version
  --generate-keys     Generate private and public key pair for Bunq installation
  --mcp               Start MCP server
  --host <host>       Host (for MCP server)
  --port <port>       Port (for MCP server)
  --bunq-client-id <id>         Bunq client ID (alternative to BUNQ_CLIENT_ID env var)
  --bunq-client-secret <secret> Bunq client secret (alternative to BUNQ_CLIENT_SECRET env var)
  --bunq-api-key <key>          Bunq API key (alternative to BUNQ_API_KEY env var)

Разработка

1. Создайте файл .dev.vars в корневом каталоге со следующим содержимым:

# When set to 1 the public/private key pair in this repo is used.
IS_DEVELOPMENT=1

# Create OAuth client in the Bunq app
BUNQ_CLIENT_ID=
BUNQ_CLIENT_SECRET=

2. Запустить сервер разработки

npm run dev

3. Настройка конфигурации MCP

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

Ограничения

• Невозможно создавать платежи с использованием потока OAuth. Можно создавать только черновики платежей.

{ "Error": [{ "error_description": "Not enough permissions to create payment." }] }