Bunq MCP

Bunq（荷兰新银行）的Model Context Protocol服务器。

可用工具

此MCP服务器提供了以下工具，用于与Bunq进行交互：

1. bunqAccounts - 获取您的Bunq账户详细信息，如账户类型、余额和ID
2. getTransactions - 查看特定账户的交易记录（付款）
3. getRequestInquiries - 获取从特定账户发出的收款请求
4. createPaymentRequest - 创建一个收款请求以接收资金到您的账户
5. getPaymentAutoAllocates - 获取账户的自动付款分配设置
6. getTopCounterparties - 根据最近的交易获取唯一的个人对手方列表
7. createDraftPayment - 创建草稿付款，并可选择安排时间（在执行前需要在应用中审核/批准）
8. createPayment - 创建实际资金转账（立即转账）。仅当使用API密钥（而非OAuth）时可用。

这些工具可以通过连接到此服务器的任何MCP客户端访问。

认证

此服务器支持两种认证模式：OAuth 和 API密钥。有关更多信息，请参阅Bunq文档。

通过Bunq应用程序创建API密钥或OAuth客户端：

1. 点击左上角的头像

2. 点击右上角的齿轮图标

3. 在“开发者”下，选择“OAuth”或“API密钥”。

4. 如果使用OAuth，请将重定向URL设置为以下内容：

   http://localhost:8788/callback

（如有需要，可以修改端口。）

启动服务器时，您可以设置BUNQ_CLIENT_ID和BUNQ_CLIENT_SECRET环境变量，或者设置BUNQ_API_KEY环境变量。或者，您也可以通过命令行参数传递客户端ID和密钥或API密钥：--bunq-client-id <id> --bunq-client-secret <secret> 或 --bunq-api-key <key>。

注意： 如果您想创建实际的资金转账（非草稿），则需要使用API密钥。

安装与使用

1. 安装bunq-mcp和mcp-remote CLI工具：

sh
npm install -g bunq-mcp mcp-remote

1. 在Bunq应用程序中，创建一个OAuth客户端或API密钥（见上文）。

2. （可选）生成新的公钥/私钥对：

sh
bunq-mcp --generate-keys

请注意，这假设openssl已安装并可在PATH中找到。如果您决定跳过此步骤，则会使用./src/keys/目录中的现有密钥。生成的新密钥将覆盖现有的密钥，并存储在全球node_modules目录中。

1. 在任意终端中启动MCP服务器：

sh
bunq-mcp --mcp --bunq-client-id --bunq-client-secret

客户端ID和密钥也可以通过BUNQ_CLIENT_ID和BUNQ_CLIENT_SECRET环境变量设置。

1. 在您喜欢的编辑器或其他MCP客户端（例如Claude Desktop）中，添加以下内容：

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

同样，如果需要，请修改端口。使用mcp-remote是因为此包使用SSE传输，而大多数客户端不支持该传输方式。有关更多信息，请参阅mcp-remote。

1. 一旦MCP服务器启动，mcp-remote应会打开您的浏览器以开始OAuth流程。

现在您应该能够提出问题，例如：

• 我当前的Bunq余额是多少？
• 我的前五个对手方是谁？
• 我的最后一笔交易是什么？

故障排除

• 如果OAuth流程有任何问题，您可以尝试删除mcp-remote在您的主目录中创建的目录：rm -rf ~/.mcp-auth。

命令行界面

用法: bunq-mcp [选项]

选项:
--help 显示帮助
--version 显示版本
--generate-keys 为Bunq安装生成公钥和私钥对
--mcp 启动MCP服务器
--host 主机（用于MCP服务器）
--port 端口（用于MCP服务器）
--bunq-client-id Bunq客户端ID（替代BUNQ_CLIENT_ID环境变量）
--bunq-client-secret Bunq客户端密钥（替代BUNQ_CLIENT_SECRET环境变量）
--bunq-api-key Bunq API密钥（替代BUNQ_API_KEY环境变量）## 开发

1. 在根目录下创建 .dev.vars 文件，内容如下：

sh

当设置为 1 时，将使用此仓库中的公钥/私钥对。

IS_DEVELOPMENT=1

在 Bunq 应用中创建 OAuth 客户端

BUNQ_CLIENT_ID=
BUNQ_CLIENT_SECRET=

1. 启动开发服务器

sh
npm run dev

1. 设置 MCP 配置

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

限制

• 使用 OAuth 流程无法创建支付。只能创建草稿支付。

json
{ "Error": [{ "error_description": "权限不足，无法创建支付。" }] }