커스텀 Parser Templates를 사용하여 송장, 영수증 및 기타 문서에서 구조화된 데이터를 추출합니다.
다른 이름 ParserBee/parserbee-mcp
- 스타
- 0
- Tools
- 6
- 다운로드, 30일
- —
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 10월 18일
- 라이선스
- MIT
ParserBee MCP란?
ParserBee은(는) MCP server입니다. 커스텀 Parser Templates를 사용하여 송장, 영수증 및 기타 문서에서 구조화된 데이터를 추출합니다. 6개 도구를 제공합니다. 예: extract_document, list_templates, get_template.
프로젝트 README에서 생성된 요약
ParserBee MCP server 정보
ParserBee MCP를 사용하면 AI 어시스턴트가 송장, 영수증, 구매 주문서, 은행 거래 내역서와 같은 비정형 문서를 정리된 데이터로 변환할 수 있습니다. 사용자는 pk_로 시작하는 ParserBee API key를 제공하여 Claude Desktop, Claude Code, Cursor 또는 VS Code와 같은 클라이언트에 이 server를 연결합니다. 이 server는 npx 또는 로컬 Node.js 설치를 통해 로컬에서 실행되며, ParserBee 서비스와 통신하여 파일을 처리합니다.
개발자는 워크플로우 관리를 위해 특정 도구를 사용합니다. extract_document 도구는 커스텀 Parser Templates를 사용하여 로컬 파일 또는 공개 링크를 처리하며, 페이지당 1페이지 크레딧을 소모합니다. 이외에도 계정 템플릿을 확인하는 list_templates, 남은 페이지 잔액을 확인하는 get_credits, 최근 10개의 요청을 검토하는 list_recent_extractions 등의 도구를 사용할 수 있습니다. 시스템은 PDF, PNG, JPG, WebP, HEIC 등 최대 50 MB 크기의 다양한 파일 형식을 지원합니다.
활용 사례
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
ParserBee MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: extract_document, list_templates, get_template, get_credits, list_recent_extractions.
추출 비용은 얼마인가요?
문서 1페이지당 1페이지 크레딧이 소모됩니다.
지원되는 파일 형식은 무엇인가요?
50 MB 이하의 PDF, PNG, JPG, WebP 또는 HEIC 파일을 업로드할 수 있습니다.
직접 만든 템플릿을 사용할 수 있나요?
네, 이 MCP server를 통해 사용자 정의 Parser Templates를 사용하여 데이터를 추출할 수 있습니다.