Enable Banking MCP

启用银行MCP服务器

  

一 MCP（模型上下文协议） 服务器 启用API银行业务，用Rust写的。让人工智能助手（Claude、Copilot等）直接访问数百家欧洲银行的开放银行数据。

______________________________________________________________________

目录

• 先决条件
• 安装
• 运作原理
• MCP配置
• 从源代码构建
• 沙盒设置
• 生产设置
• 环境变量
• OAuth回调流
• 可用工具
• 命令

______________________________________________________________________

安装

macOS/Linux——一行代码：

curl -fsSL https://raw.githubusercontent.com/Algiras/enable-banking-mcp/main/install.sh | sh

然后为您的环境运行安装向导：

# Sandbox (testing)
enable-banking-mcp configure && enable-banking-mcp init && enable-banking-mcp install

# Production (real bank)
enable-banking-mcp register && enable-banking-mcp init && enable-banking-mcp install

窗户： 下载 .exe 从 发布 并运行 enable-banking-mcp.exe install.

______________________________________________________________________

先决条件

你需要一个免费的 启用银行服务 在使用此服务器之前，请先使用开发人员帐户。启用银行业务是API层，通过开放银行业务（PSD2）连接数百家欧洲银行。

创建启用银行账户

1. 首选 enablebanking.com 然后单击 免费开始
2. 验证您的电子邮件并登录 控制面板

从这里，您将创建一个 沙盒 申请（免费，无需真实银行）或 生产 申请（需要经过一个简短的审批流程）。

flowchart LR
    A(["enablebanking.com\nSign up for free"]) --> B["Control Panel\nenablebanking.com/cp"]
    B --> C["Sandbox App\nFree · Instant · Test data"]
    B --> D["Production App\nReal banks · Requires approval"]
    C --> E["enable-banking-mcp\nconfigure + init + install"]
    D --> E

______________________________________________________________________

运作原理

服务器作为MCP stdio进程运行。你的AI助手调用以下工具 start_authorization, create_session, get_account_balances等等。银行登录后，OAuth代码显示在GitHub Pages页面上，不需要本地服务器。

flowchart LR
    A(["🤖 AI Assistant\nClaude / Copilot"]) -- "tool calls\n(stdio / MCP)" --> B["⚙️ MCP Server\nenable-banking-mcp"]
    B -- "REST API\n(JWT auth)" --> C(["🏦 Enable Banking API\napi.enablebanking.com"])
    C -- "bank data" --> B
    B -- "OAuth URL" --> D(["🌐 Browser"])
    D -- "user logs in" --> E(["🏛️ Bank"])
    E -- "redirect + code" --> F(["📄 GitHub Pages\nalgiras.github.io/enable-banking-mcp/callback"])
    F -- "user copies code" --> A

______________________________________________________________________

MCP配置

运行后 enable-banking-mcp install，配置是自动写入的。下面的示例显示了生成的内容。

克劳德桌面版

文件： ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）\ 文件： %APPDATA%\Claude\claude_desktop_config.json （Windows）

{
  "mcpServers": {
    "enable-banking": {
      "command": "/usr/local/bin/enable-banking-mcp",
      "env": {
        "ENABLE_BANKING_ENV": "sandbox",
        "ENABLE_BANKING_APP_ID": "your-app-id",
        "ENABLE_BANKING_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nMIIJ...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

VS代码(.vscode/mcp.json)

{
  "servers": {
    "enable-banking": {
      "type": "stdio",
      "command": "/usr/local/bin/enable-banking-mcp",
      "env": {
        "ENABLE_BANKING_ENV": "sandbox",
        "ENABLE_BANKING_APP_ID": "your-app-id",
        "ENABLE_BANKING_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nMIIJ...\n-----END PRIVATE KEY-----"
      }
    }
  }
}

使用a .env 改为文件

地点a .env 运行二进制文件的目录中的文件：

ENABLE_BANKING_ENV=sandbox
ENABLE_BANKING_APP_ID=your-app-id
ENABLE_BANKING_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIJ...\n-----END PRIVATE KEY-----"

注： 私钥中的新行必须转义为 \n 在一条线上。

______________________________________________________________________

从源代码构建

git clone https://github.com/Algiras/enable-banking-mcp
cd enable-banking-mcp
cargo build --release

二进制文件位于 target/release/enable-banking-mcp.

所有平台的预构建二进制文件都可以在 发布页面:

______________________________________________________________________

沙盒设置

使用此功能在没有真实银行账户的情况下进行测试。Enable Banking为模拟银行提供预定义的测试用户。

flowchart TD
    A(["Start"]) --> B["1. Get Sandbox credentials\nfrom enablebanking.com/cp"]
    B --> C["2. Create .env file\nENABLE_BANKING_ENV=sandbox"]
    C --> D["3. run: enable-banking-mcp init\nOR ask AI to start_authorization"]
    D --> E["4. Log in with sandbox\ntest user in browser"]
    E --> F["Browser redirects to\nalgiras.github.io/enable-banking-mcp/callback"]
    F --> G["Copy the code shown\nand paste it back to AI"]
    G --> H["Session created &\nsaved locally"]
    H --> I["5. enable-banking-mcp install"]
    I --> J(["✅ Ready"])

1.在控制面板中创建沙盒应用程序

1. 登录 enablebanking.com/cp
2. 点击 应用程序 在左侧边栏中
3. 点击 +新应用程序
4. 填写表格：

- 名字 --任何名称，例如。 My MCP Sandbox - 环境 --选择 沙盒 - 重定向URL --进入 https://algiras.github.io/enable-banking-mcp/callback - 描述、隐私策略URL--可以是沙盒的占位符值

1. 点击 创建
2. 在应用程序详细信息页面上，注意您的 应用标识符 （UUID）
3. 点击 下载私钥 --保存 .pem 文件放在安全的地方

显示私钥 仅一次。如果您丢失了它，请删除该应用程序并创建一个新的应用程序。

2.配置

创建一个 .env 项目根目录中的文件：

ENABLE_BANKING_ENV=sandbox
ENABLE_BANKING_APP_ID=your-app-id-here
ENABLE_BANKING_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIJ...your key...\n-----END PRIVATE KEY-----"

注： 私钥中的新行必须转义为 \n 当放置在单线上时 .env.

或者运行交互式向导：

./target/release/enable-banking-mcp configure

3.连接沙盒库

请您的AI助手启动授权流程，或手动执行：

./target/release/enable-banking-mcp init

LT中可用的沙盒库 （示例）：

其他国家： 沙盒测试用户因银行而异。问你的AI助手 "list available banks in " --the get_available_banks 该工具在响应中返回支持沙盒用户凭据的每个银行的凭据。

当浏览器打开银行授权页面时，使用沙盒测试凭据登录。批准后，浏览器将重定向到 https://algiras.github.io/enable-banking-mcp/callback 并显示授权码。复制它并将其粘贴回AI（或调用 get_captured_code 带有完整URL）。

5.安装到克劳德桌面/VS代码

./target/release/enable-banking-mcp install

这将MCP服务器配置写入 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）。

重要提示： 运行后重新启动Claude Desktop（或重新加载VS Code窗口） install 新工具的出现。

______________________________________________________________________

生产设置

使用此功能连接您的真实银行账户。

flowchart TD
    A(["Start"]) --> B["1. enable-banking-mcp register\nGenerates RSA keys + registers app"]
    B --> C["2. Log in to enablebanking.com/cp\nWhitelist your IBAN"]
    C --> D["3. enable-banking-mcp init\nSelect your bank + country"]
    D --> E["Browser opens bank login"]
    E --> F["Log in & approve access\nat your real bank"]
    F --> G["Redirect to\nalgiras.github.io/enable-banking-mcp/callback"]
    G --> H["Copy code, paste to AI\nsession saved to ~/.enable-banking/sessions.json"]
    H --> I["4. enable-banking-mcp install"]
    I --> J(["✅ Ready"])

1.在控制面板中创建生产应用程序

1. 登录 enablebanking.com/cp
2. 点击 应用程序→ + 新应用
3. 填写表格：

- 名字 --您的应用程序名称 - 环境 --选择 生产 - 重定向URL — https://algiras.github.io/enable-banking-mcp/callback - 描述, 隐私政策URL, 术语URL, Gdpr联系电子邮件 --生产所需

1. 点击 创建 --启用银行服务可能需要对生产访问进行简短审查
2. 注意你的 应用标识符 并下载您的 私钥

或者 register 命令自动执行步骤3至5：

enable-banking-mcp register

这在本地生成一个RSA密钥对，通过API注册应用程序，并将凭据保存到 .env 自动。

2.将您的IBAN列入白名单

1. 登录到 启用银行控制面板
2. 查找您新注册的应用程序
3. 将您的IBAN添加到白名单

在授予生产数据访问权限之前，这是必需的。

3.配置环境

这 register 命令写入 .env 自动。验证它是否包含：

ENABLE_BANKING_ENV=production
ENABLE_BANKING_APP_ID=your-app-id
ENABLE_BANKING_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"

4.连接您的银行

./target/release/enable-banking-mcp init

CLI将：

1. 列出您所在国家的可用银行
2. 在浏览器中打开银行的授权URL
3. 批准后，浏览器将重定向到 https://algiras.github.io/enable-banking-mcp/callback --复制显示的代码
4. 出现提示时粘贴代码（或完整URL）--会话保存到 ~/.enable-banking/sessions.json

5.安装

./target/release/enable-banking-mcp install

重要提示： 运行后重新启动Claude Desktop（或重新加载VS Code窗口） install 新工具的出现。

______________________________________________________________________

环境变量

这些可以在 .env 例如工作目录中的文件或作为真实环境变量。

______________________________________________________________________

OAuth回调流

sequenceDiagram
    actor User
    participant AI as AI Assistant
    participant MCP as MCP Server
    participant API as Enable Banking API
    participant Browser as Browser
    participant Bank as Bank
    participant GH as GitHub Pages

    User->>AI: "Connect my bank"
    AI->>MCP: start_authorization(bank, country)
    MCP->>API: POST /auth/
    API-->>MCP: { url: "https://tilisy..." }
    MCP-->>AI: authorization URL + instructions
    AI-->>User: "Open this URL in your browser"

    User->>Browser: Opens authorization URL
    Browser->>Bank: User logs in & approves
    Bank-->>GH: GET /callback?code=abc123
    GH-->>Browser: Shows code with copy button
    User->>AI: Pastes code (or full URL)

    AI->>MCP: get_captured_code(code_or_url)
    MCP-->>AI: { code: "abc123" }
    AI->>MCP: create_session(code)
    MCP->>API: POST /sessions/
    API-->>MCP: { session_id, accounts[] }
    note over MCP: Session saved to ~/.enable-banking/sessions.json
    MCP-->>AI: session + account list
    AI-->>User: "Connected! Found N accounts."

回调故障排除：

______________________________________________________________________

可用工具

______________________________________________________________________

命令