银行API集成服务

Token.io MCP Server for Claude AI是一个通过模型上下文协议(MCP)使Claude AI能够与Token.io银行API交互的服务,支持银行信息检索、支付链接生成和账户信息服务等功能。

  • by samfrench27
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 samfrench27/tokenio-mcp

使用说明

适用于Claude AI的Token.io MCP服务器

一个模型上下文协议(MCP)服务器,使Claude AI能够与Token.io银行API进行交互。该服务器允许Claude通过自然语言请求执行各种财务操作。

作者

由Sam French开发(samfrench.io)

许可证

该项目在MIT许可证下发布。有关详细信息,请参阅LICENSE文件。

特性

  • 银行信息检索:按名称、国家或支付网络支持查找银行
  • 支付链接生成:生成英镑或欧元货币的支付链接
  • 账户信息服务(AIS):在用户同意的情况下访问帐户信息、余额和交易
  • Claude AI集成:通过模型上下文协议与Claude AI无缝集成
  • 安全的API集成:使用Token.io沙盒环境进行安全测试

运作原理

该项目使用模型上下文协议(MCP)在Claude AI和Token.io银行API之间建立了一座桥梁。当你与Claude互动时,它可以:

  1. 识别您执行银行业务的意图
  2. 从您的请求中提取相关参数
  3. 通过MCP服务器调用相应的Token.io API
  4. 返回有用的财务信息或生成链接

对话示例

用户:“让我看看英国支持更快支付的银行”

克劳德:“以下是英国支持更快支付的银行:[银行名单]”

用户:“创建一个50英镑的付款链接,完成后重定向到我的网站”

克劳德:“我为您创建了一个付款链接。它是:https://app.sandbox.token.io/session/[令牌id]“

用户:“连接到我的巴克莱银行账户以查看我的交易”

克劳德:“我将帮助您连接到您的巴克莱银行账户。请点击此链接授权访问:[授权URL]”

用户:“显示我关联银行账户的最新交易记录”

克劳德:“以下是您最近的交易:[交易数据]”

账户信息服务(AIS)流程

AIS功能遵循以下流程:

  1. 创建令牌请求:发起访问帐户信息的请求
  2. 银行授权:为用户生成一个URL,以便在银行进行身份验证
  3. 检索访问令牌:成功授权后获取访问令牌
  4. 访问帐户数据:使用令牌获取帐户、余额和交易

技术实现

服务器是使用以下方式构建的:

  • Node.js
  • 模型上下文协议SDK(@modelcontextprotocol/SDK)
  • Token.io API
  • Zod用于验证

该架构由以下部分组成:

  • mcpserver.js:定义工具及其功能
  • mcp_index.js:设置stdio传输以与Claude连接

设置

先决条件

  • Node.js(v14或更高版本)
  • npm
  • Claude桌面(或兼容的Claude界面)

安装

  1. 克隆此存储库:
git clone https://github.com/samfrench27/tokenio-mcp.git
cd tokenio-mcp
  1. 安装依赖项:
npm install
  1. 构建项目:
npm run build

使用Claude Desktop进行配置

要将此MCP服务器与Claude Desktop一起使用:

  1. 找到您的Claude Desktop配置文件:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  2. 将Token.io MCP服务器添加到您的配置中:

{
  "mcpServers": {
    "tokenio": {
      "command": "node",
      "args": [
        "/path/to/tokenio-mcp/mcp_index.js"
      ]
    }
  }
}

替换 /path/to/tokenio-mcp 在您的系统上显示此项目的实际路径。

可用工具

MCP服务器目前公开了以下工具:

银行信息

  • tokenio-get-banks:获取具有可选过滤功能的银行列表
  • tokenio-get-bank-details:获取特定银行的详细信息

支付

  • tokenio-create-payment-link:为特定金额和货币生成付款链接

账户信息服务(AIS)

  • tokenio-create-ais-token-request:创建用于访问帐户的AIS令牌请求
  • tokenio-initiate-bank-authorization:启动银行授权流程
  • tokenio-get-token-request-result:授权后获取访问令牌
  • tokenio-get-accounts:检索所有关联的银行账户
  • tokenio-get-account-balance:获取特定账户的余额信息
  • tokenio-get-account-transactions:获取特定账户的交易历史记录

该架构被设计为可扩展的,允许根据需要添加额外的Token.io功能。

可扩展性

MCP服务器的设计考虑了可扩展性。可以通过以下方式向服务器添加其他银行操作:

  1. 在tokenio.js模块中实现新的API函数
  2. 在mcp_server.js文件中添加新的工具定义
  3. 在MCP服务器上注册工具

免责声明

本项目仅用于演示目的。它没有得到Token.io的正式认可或支持。该集成使用Token.io沙盒环境,未经适当的安全审查和增强,不得用于生产目的。