BankConv

BankConv MCP 服务

通过 Claude、Cursor、VS Code 和其他 AI 助手，将 PDF 银行对账单转换为交易记录、CSV、OFX、QFX、QBO 或 Xero CSV。

让助手访问你电脑上的对账单，并告诉它你需要什么：要分析的交易记录、CSV，或可导入会计软件的文件。服务会将 PDF 上传到 BankConv，等待转换完成，然后返回交易记录或将文件保存在 PDF 旁边。

You: Convert ~/Downloads/chase-september.pdf to QBO for QuickBooks Desktop.
Assistant: Saved QBO to ~/Downloads/chase-september.qbo.

你将获得

• 交易记录，包含实际日期、单一带符号金额（收入为正，支出为负）和滚动余额。不包含期初余额和汇总行。
• 文件：CSV、OFX（Xero、Sage、MYOB、QuickBooks Online）、QFX（Quicken）、QBO（QuickBooks Desktop Web Connect，使用你银行的 QuickBooks ID）和 Xero CSV（使用 Xero 自有列）。
• 受密码保护的 PDF、扫描版对账单和多页对账单。

设置

1. 在 BankConv 的 Team → API keys 中创建 API 密钥（https://app.bankconv.com/teams/api-keys）。转换会占用 BankConv 套餐中的页数。
2. 使用 BANKCONV_API_KEY 中的密钥，将服务添加到你的助手。

Claude Code

claude mcp add bankconv -e BANKCONV_API_KEY=sk_live_your_key -- npx -y bankconv-mcp

Claude Desktop

一键安装：下载 bankconv.mcpb 并打开。Claude Desktop 会安装该服务并提示你输入 API 密钥。

或者将以下内容添加到 claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_key" }
    }
  }
}

Cursor、Windsurf 和其他客户端

在客户端的 MCP 设置中使用相同的 command、args 和 env（对于 Cursor，使用 ~/.cursor/mcp.json）。

VS Code

{
  "servers": {
    "bankconv": {
      "command": "npx",
      "args": ["-y", "bankconv-mcp"],
      "env": { "BANKCONV_API_KEY": "sk_live_your_key" }
    }
  }
}

需要 Node.js 20 或更高版本。

工具

工具	功能
convert_statement	转换此电脑上的 PDF。返回交易记录，或保存为 CSV、OFX、QFX、QBO 或 Xero CSV（默认保存在 PDF 旁边，除非你指定 save_to）。如果 PDF 有密码，则需要提供密码。
get_transactions	获取之前转换的交易记录。
download_statement	将之前转换的文件保存为 CSV、OFX、QFX、QBO 或 Xero CSV（默认保存在 Downloads 中，除非你指定位置）。
list_conversions	列出近期转换及其状态。
get_credits	查看本计费周期还剩多少页数。

提示词示例

• “转换 statement.pdf，并告诉我金额最大的五笔支出。”
• “将 ~/Statements/2026 中的每个 PDF 转换为适用于 Xero 的 OFX 文件。”
• “将 amex-march.pdf 转换为 QuickBooks Desktop 使用的 QBO。PDF 密码是 4821。”
• “根据 chase-sep.pdf，按类别汇总我 9 月的支出。”

Agent 技能

对于不支持 MCP 的 Agent，skills/bankconv/SKILL.md 介绍了如何通过 curl 使用 REST API 完成相同的工作流。

隐私

PDF 会通过 HTTPS 上传到 BankConv 并在那里处理。PDF 及其转换后的文件会在 24 小时后自动删除；如果团队选择了更长的保留期限，则会在 48 或 72 小时后删除；请参阅安全与数据处理。该服务只读取你指定的文件，也只写入你要求保存的文件。

配置

变量	默认值
BANKCONV_API_KEY	（必填）	你的 BankConv API 密钥
BANKCONV_API_URL	https://bankconv.com/api/v1	API 基础 URL

链接

• BankConv · MCP 服务页面 · API 文档 · 支持的银行

许可证

MIT