适用于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互动时，它可以：
- 识别您执行银行业务的意图
- 从您的请求中提取相关参数
- 通过MCP服务器调用相应的Token.io API
- 返回有用的财务信息或生成链接
对话示例
用户：“让我看看英国支持更快支付的银行”
克劳德：“以下是英国支持更快支付的银行：\[银行名单\]”
用户：“创建一个50英镑的付款链接，完成后重定向到我的网站”
克劳德：“我为您创建了一个付款链接。它是：https://app.sandbox.token.io/session/\[令牌id\]“
用户：“连接到我的巴克莱银行账户以查看我的交易”
克劳德：“我将帮助您连接到您的巴克莱银行账户。请点击此链接授权访问：\[授权URL\]”
用户：“显示我关联银行账户的最新交易记录”
克劳德：“以下是您最近的交易：\[交易数据\]”
账户信息服务（AIS）流程
AIS功能遵循以下流程：
- 创建令牌请求：发起访问帐户信息的请求
- 银行授权：为用户生成一个URL，以便在银行进行身份验证
- 检索访问令牌：成功授权后获取访问令牌
- 访问帐户数据：使用令牌获取帐户、余额和交易
技术实现
服务器是使用以下方式构建的：
- Node.js
- 模型上下文协议SDK（@modelcontextprotocol/SDK）
- Token.io API
- Zod用于验证
该架构由以下部分组成：
- mcpserver.js：定义工具及其功能
- mcp_index.js：设置stdio传输以与Claude连接
设置
先决条件
- Node.js（v14或更高版本）
- npm
- Claude桌面（或兼容的Claude界面）
安装
- 克隆此存储库：
git clone https://github.com/samfrench27/tokenio-mcp.git
cd tokenio-mcp- 安装依赖项：
npm install- 构建项目：
npm run build使用Claude Desktop进行配置
要将此MCP服务器与Claude Desktop一起使用：
- 找到您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json
- 将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服务器的设计考虑了可扩展性。可以通过以下方式向服务器添加其他银行操作：
- 在tokenio.js模块中实现新的API函数
- 在mcp_server.js文件中添加新的工具定义
- 在MCP服务器上注册工具
免责声明
本项目仅用于演示目的。它没有得到Token.io的正式认可或支持。该集成使用Token.io沙盒环境，未经适当的安全审查和增强，不得用于生产目的。