parserbee-mcp

ParserBee MCP 服务

一个用于 ParserBee 的 Model Context Protocol 服务。它可让 AI 助手使用你的 Parser 模板，从发票、收据、采购订单、银行对账单和其他文档中提取结构化数据。

可以向助手提出类似以下的问题：

• “用我的 Invoice 模板提取 ~/Downloads/inv-2041.pdf 中的发票。”
• “读取此文件夹中的所有收据，并用表格列出商家、日期和总额。”
• “我还剩多少 ParserBee 页面额度？”

工具

工具	功能
extract_document	使用 Parser 模板从本地文件（file_path）或公开链接（file_url）中提取数据。每页消耗 1 个页面额度。
list_templates	列出你账户中的 Parser 模板及其字段
get_template	获取一个 Parser 模板及其所有字段
get_credits	查看页面额度余额、套餐和订阅状态
list_recent_extractions	查看最近 10 次提取请求
get_extraction	查看一项提取请求及其提取的数据

开始之前

1. 在 app.parserbee.com 创建免费账户。新账户可获得 25 个免费页面额度，无需信用卡。
2. 创建一个 Parser 模板：上传一份示例文档，让 AI 为你生成字段；或者从模板库中选择现成模板。
3. 从控制面板的 Settings 中复制你的 API 密钥。密钥以 pk_ 开头。

你需要 Node.js 18 或更高版本。

设置

Claude Desktop

打开 Settings > Developer > Edit Config 并添加：

{
  "mcpServers": {
    "parserbee": {
      "command": "npx",
      "args": ["-y", "parserbee-mcp"],
      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
    }
  }
}

重启 Claude Desktop。

Claude Code

claude mcp add parserbee --scope user -e PARSERBEE_API_KEY=pk_your_api_key -- npx -y parserbee-mcp

--scope user 会让所有文件夹都能使用 ParserBee。否则，Claude Code 只会将服务添加到你运行命令所在的文件夹。之后启动新的 Claude Code 会话，并运行 claude mcp list 检查。

Cursor

将相同的 mcpServers 配置块添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）。

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "parserbee": {
      "command": "npx",
      "args": ["-y", "parserbee-mcp"],
      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
    }
  }
}

从本地副本运行

git clone https://github.com/ParserBee/parserbee-mcp.git
cd parserbee-mcp
npm install
PARSERBEE_API_KEY=pk_your_api_key node dist/index.js

将客户端指向 node /path/to/parserbee-mcp/dist/index.js。

设置项

环境变量	必填	用途
PARSERBEE_API_KEY	是	你从 Settings 获取的 API 密钥
PARSERBEE_BASE_URL	否	默认为 https://app.parserbee.com

返回内容

extract_document 会返回 API 响应。提取出的字段位于 data 中，其结构与 Parser 模板一致：

{
  "success": true,
  "request_id": "req_abc123",
  "data": {
    "invoice_number": "INV-2026-001",
    "vendor_name": "Acme Corp",
    "total_amount": 1500
  },
  "credits_remaining": 449,
  "usage": { "pages_processed": 1, "credits_charged": 1 }
}

文件格式可以是 PDF、PNG、JPG、WebP 或 HEIC，最大为 50 MB。扫描件和手机拍摄的照片也适用。API 错误（如密钥无效、页面额度用尽或模板未知）会作为工具错误返回，并附上 ParserBee 错误代码，以便助手告诉你如何修正。

试用

sample-invoices 仓库提供了 18 份免费的测试发票，并列出了每个字段的正确值，方便你检查结果。

相关资源

• parserbee-python 和 parserbee-node：客户端库
• parserbee-n8n：n8n 工作流
• parserbee-postman：Postman 集合和 OpenAPI 文件
• 免费浏览器工具：发票解析器、银行对账单转换器、收据扫描器
• 正在比较工具？请查看我们对发票 OCR 软件的测试。

开发

npm install
npm test
npm run build

许可证

MIT