Fio Bank MCP

FIO Bank MCP 服务

面向捷克共和国 FIO Bank API 的 MCP（Model Context Protocol）服务。允许 Claude 等 AI 助手访问 FIO Bank 账户交易记录。

安装

pnpm install
pnpm build

配置

获取 API 令牌

1. 登录 FIO Bank 网上银行
2. 前往 设置 → API
3. 创建新令牌（需要短信或推送通知验证）
4. 使用令牌前等待 5 分钟

令牌属性

• 每个令牌仅对一个账户有效
• 最长有效期：180 天
• 可在每次登录网上银行时自动续期

使用方法

使用 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "fio-bank": {
      "command": "node",
      "args": ["/path/to/fio-bank-mcp/dist/index.js"],
      "env": {
        "FIO_API_TOKEN": "your-64-character-token-here"
      }
    }
  }
}

可用工具

fio_get_transactions

获取指定日期范围内的账户交易记录。

参数：

名称	类型	必填	描述
dateFrom	字符串	是	开始日期（YYYY-MM-DD）
dateTo	字符串	是	结束日期（YYYY-MM-DD）
token	字符串	否	API 令牌（如果未提供，则使用 FIO_API_TOKEN 环境变量）

返回内容：

• 账户信息（IBAN、BIC、余额）
• 交易记录列表，包括：
  • 交易 ID、日期、金额、货币
  • 对方账户（账号、名称、银行）
  • 付款标识（可变、固定、特定）
  • 收款人留言、备注
  • 交易类型

本地测试

使用 MCP Inspector 通过 Web 界面测试服务：

npx @modelcontextprotocol/inspector node dist/index.js

这会打开一个浏览器，你可以在其中查看可用工具、传入参数调用工具并查看响应。

传入 API 令牌：

FIO_API_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/index.js

API 速率限制

每个令牌每 30 秒最多 1 个请求。 如有需要，服务会自动等待。

数据访问

• 90 天以内的数据：可立即访问
• 超过 90 天的数据：需要在网上银行临时解锁（设置 → API → 点击锁形图标，有效期为 10 分钟）

错误代码

代码	描述
404	URL 或令牌无效
409	超出速率限制（等待 30 秒）
413	响应中的交易记录过多
422	请求数据无效
500	内部服务器错误

开发

pnpm install      # Install dependencies
pnpm build        # Build TypeScript
pnpm lint         # Run ESLint
pnpm typecheck    # Type check without emitting

资源

• FIO Bank API 文档（捷克语）
• MCP 协议

许可证

MIT