Банк MCP

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

Скриншот

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

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

bunqAccounts — получите данные о своих счетах Bunq, такие как тип счета, баланс и идентификатор.
getTransactions - Просмотр транзакций (платежей) для определенного счета
getRequestInquiries — получение запросов на получение денег, отправленных с определенного счета
createPaymentRequest - Создайте запрос на оплату для получения денег на свой счет
getPaymentAutoAllocates — получение настроек автоматического распределения платежей для учетной записи
getTopCounterpartyes — получение списка уникальных контрагентов на основе последних транзакций
createDraftPayment — создание черновиков платежей с возможностью планирования (требуется проверка/утверждение в приложении перед выполнением)
createPayment - Создание платежей реальными деньгами (переводы происходят немедленно). Доступно только при использовании ключа API (не OAuth).

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

Related MCP server: MCP Blockchain Query Server

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

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

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

Нажмите на свое лицо в левом верхнем углу.
Нажмите на шестеренку в правом верхнем углу.
В разделе «Разработчики» перейдите в раздел «OAuth» или «API-ключи».
При использовании 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.

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

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

npm install -g bunq-mcp mcp-remote

В приложении Bunq создайте клиент OAuth или ключ API (см. выше).
(Необязательно) Создайте новую пару открытого и закрытого ключей:

bunq-mcp --generate-keys

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

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

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

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

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

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

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

Как только сервер 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)

Разработка

Создайте файл .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=

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

npm run dev

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

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

Ограничения

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

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

Bunq MCP