カスタムのParser Templatesを使用して、請求書や領収書、その他のドキュメントから構造化データを抽出します。
別名 ParserBee/parserbee-mcp
- スター
- 0
- ツール
- 6
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.1
- 最終コミット
- 2026年10月18日
- ライセンス
- MIT
ParserBee MCPとは
ParserBeeはMCPサーバーです。 カスタムのParser Templatesを使用して、請求書や領収書、その他のドキュメントから構造化データを抽出します。. 6個のツールを提供しており、extract_document, list_templates, get_templateなどがあります。
プロジェクトのREADMEから生成された概要
ParserBee MCP server について
ParserBee MCPは、請求書、領収書、注文書、銀行取引明細書などの非構造化ドキュメントを、整理されたデータに変換することをAIアシスタントに可能にします。ユーザーは、pk_で始まるParserBee APIキーを提供することで、このMCP serverをClaude Desktop、Claude Code、Cursor、またはVS Codeなどのクライアントに接続できます。このサーバーはnpxまたはローカルのNode.js環境を通じてローカルで実行され、ParserBeeサービスと通信してファイルを処理します。
開発者は、ワークフローを管理するために特定のツールを使用します。extract_documentツールは、カスタムのParser Templatesを使用してローカルファイルまたは公開リンクを処理し、1ページにつき1ページのクレジットを消費します。その他の利用可能なツールには、アカウントのテンプレートを表示するlist_templates、残りのページ残高を確認するget_credits、および直近10件のリクエストを確認するlist_recent_extractionsがあります。システムは、最大50 MBまでのPDF、PNG、JPG、WebP、HEICを含むさまざまなファイル形式をサポートしています。
できること
- 1特定のファイルからデータを抽出定義済みのテンプレートを使用して、ローカルのPDFから情報を取得するようアシスタントに指示します。
- 2ドキュメントフォルダの一括処理ディレクトリ内の複数の領収書を読み取り、その詳細をテーブルにまとめるようAIに指示します。
- 3アカウント使用状況の監視ParserBeeアカウントのページクレジットの残高を確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ParserBee MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにParserBee MCPをインストール
$ claude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcpCursorにParserBee MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}VS CodeにParserBee MCPをインストール
.vscode/mcp.json
{
"servers": {
"parserbee-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}VS Code CLIにParserBee MCPをインストール
$ code --add-mcp '{"name":"parserbee-mcp","type":"stdio","command":"npx","args":["-y","parserbee-mcp"],"env":{"PARSERBEE_API_KEY":"<YOUR_PARSERBEE_API_KEY>"}}'Claude DesktopにParserBee MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}CodexにParserBee MCPをインストール
$ codex mcp add parserbee-mcp --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' -- npx -y parserbee-mcpCodex config.tomlにParserBee MCPをインストール
~/.codex/config.toml
[mcp_servers.parserbee-mcp] command = "npx" args = ["-y", "parserbee-mcp"] [mcp_servers.parserbee-mcp.env] PARSERBEE_API_KEY = "<YOUR_PARSERBEE_API_KEY>"
Gemini CLIにParserBee MCPをインストール
$ gemini mcp add -s user -e 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp npx -- -y parserbee-mcpGemini settings.jsonにParserBee MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}ParserBee MCPツール 6
READMEから検出extract_documentlist_templatesget_templateget_creditslist_recent_extractionsget_extraction
| extract_document | — | |
| list_templates | — | |
| get_template | — | |
| get_credits | — | |
| list_recent_extractions | — | |
| get_extraction | — |
設定
PARSERBEE_API_KEY必須シークレットYour ParserBee API key, from Settings in the dashboard
| 名前 | 説明 | 種類 |
|---|---|---|
| PARSERBEE_API_KEY | Your ParserBee API key, from Settings in the dashboard | 必須シークレット |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るParserBee MCP server
A Model Context Protocol server for ParserBee. It lets an AI assistant extract structured data from invoices, receipts, purchase orders, bank statements and other documents, using your Parser Templates.
Ask your assistant things like:
- "Extract the invoice in ~/Downloads/inv-2041.pdf with my Invoice template."
- "Read every receipt in this folder and give me a table of merchant, date and total."
- "How many ParserBee page credits do I have left?"
Tools
| Tool | What it does |
|---|---|
extract_document |
Extract data from a local file (file_path) or a public link (file_url) with a Parser Template. 1 page credit per page. |
list_templates |
List the Parser Templates in your account, with their fields |
get_template |
One Parser Template with all of its fields |
get_credits |
Page credit balance, plan and subscription status |
list_recent_extractions |
The last 10 extraction requests |
get_extraction |
One extraction request, with its extracted data |
Before you start
- Create a free account at app.parserbee.com. New accounts get 25 free pages, no credit card.
- Create a Parser Template: upload one sample document and the AI builds the fields for you, or pick a ready-made one from the template library.
- Copy your API key from Settings in the dashboard. It starts with
pk_.
You need Node.js 18 or later.
Set up
Claude Desktop
Open Settings > Developer > Edit Config and add:
{
"mcpServers": {
"parserbee": {
"command": "npx",
"args": ["-y", "parserbee-mcp"],
"env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
}
}
}
Restart Claude Desktop.
Claude Code
claude mcp add parserbee --scope user -e PARSERBEE_API_KEY=pk_your_api_key -- npx -y parserbee-mcp
--scope user makes ParserBee available in every folder. Without it, Claude Code adds the server only to the folder you run the command in. Start a new Claude Code session afterwards, then check it with claude mcp list.
Cursor
Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"parserbee": {
"command": "npx",
"args": ["-y", "parserbee-mcp"],
"env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
}
}
}
From a local copy
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
Point your client at node /path/to/parserbee-mcp/dist/index.js.
Settings
| Environment variable | Required | Use |
|---|---|---|
PARSERBEE_API_KEY |
Yes | Your API key from Settings |
PARSERBEE_BASE_URL |
No | Defaults to https://app.parserbee.com |
What comes back
extract_document returns the API response. The extracted fields are in data, shaped like your Parser Template:
{
"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 }
}
Files can be PDF, PNG, JPG, WebP or HEIC, up to 50 MB. Scans and phone photos work. API errors (an invalid key, no page credits left, an unknown template) come back as tool errors with the ParserBee error code, so the assistant can tell you what to fix.
Try it
The sample-invoices repository has 18 free test invoices with the correct value of every field, so you can check the results.
Related
- parserbee-python and parserbee-node: client libraries
- parserbee-n8n: n8n workflows
- parserbee-postman: Postman collection and OpenAPI file
- Free browser tools: invoice parser, bank statement converter, receipt scanner
- Comparing tools? See our test of invoice OCR software.
Development
npm install
npm test
npm run build
License
MIT
ParserBee MCPのよくある質問
ParserBee MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ParserBee MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
ParserBee MCPが提供するツールは
6個のツールを提供しており、extract_document, list_templates, get_template, get_credits, list_recent_extractionsなどがあります。
抽出コストはいくらですか?
処理されたページごとに1ページ分のクレジットを消費します。
サポートされているファイル形式は何ですか?
50 MBまでのPDF、PNG、JPG、WebP、またはHEICファイルをアップロードできます。
独自のテンプレートを使用できますか?
はい、このMCP serverを使用すると、独自のParser Templatesを使用してデータを抽出できます。