邦克 MCP
Bunq(荷兰新银行)的模型上下文协议服务器。

可用工具
该 MCP 服务器提供以下与 Bunq 交互的工具:
bunqAccounts - 获取您的 Bunq 帐户,包括帐户类型、余额和 ID 等详细信息
getTransactions - 查看特定账户的交易(付款)
getRequestInquiries - 获取您从特定账户发送的付款请求
createPaymentRequest - 创建付款请求以将钱款存入您的账户
getPaymentAutoAllocates - 获取帐户的自动付款分配设置
getTopCounterparties - 根据最近的交易获取唯一个人交易对手列表
createDraftPayment - 创建具有可选计划的付款草稿(执行前需要在应用程序中进行审核/批准)
createPayment - 创建真实货币付款(立即转账)。仅在使用 API 密钥(而非 OAuth)时可用。
可以通过连接到该服务器的任何 MCP 客户端访问这些工具。
Related MCP server: MCP Blockchain Query Server
验证
此服务器支持两种身份验证模式: OAuth和API Key 。有关更多信息,请参阅Bunq 文档。
通过 Bunq 应用程序创建 API 密钥或 OAuth 客户端:
按压左上角的脸部
按下右上角的齿轮
在“开发人员”下,转到“OAuth”或“API 密钥”。
如果使用 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 密钥。
安装与使用
安装
bunq-mcp和mcp-remoteCLI 工具:
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环境变量设置客户端 ID 和密码。
在您最喜欢的编辑器或其他 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。
命令行界面
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." }] }