Extraia dados estruturados de faturas, recibos e outros documentos usando Parser Templates personalizados.
Também conhecido como ParserBee/parserbee-mcp
- Stars
- 0
- Ferramentas
- 6
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.1
- Último commit
- 18 de out. de 2026
- Licença
- MIT
O que é o MCP ParserBee?
ParserBee é um MCP server. Extraia dados estruturados de faturas, recibos e outros documentos usando Parser Templates personalizados. Ele expõe 6 ferramentas, como extract_document, list_templates, get_template.
Resumo gerado a partir do README do projeto
Sobre o MCP server de ParserBee
O ParserBee MCP permite que assistentes de IA transformem documentos não estruturados, como faturas, recibos, pedidos de compra e extratos bancários, em dados organizados. Os usuários conectam este servidor a clientes como Claude Desktop, Claude Code, Cursor ou VS Code fornecendo uma chave de API do ParserBee que começa com pk_. O servidor roda localmente via npx ou uma instalação local do Node.js e se comunica com o serviço ParserBee para processar arquivos.
Desenvolvedores utilizam ferramentas específicas para gerenciar seu fluxo de trabalho. A ferramenta extract_document processa arquivos locais ou links públicos usando Parser Templates personalizados, consumindo um crédito de página por página. Outras ferramentas disponíveis incluem list_templates para visualizar os templates da conta, get_credits para verificar o saldo de páginas restante e list_recent_extractions para revisar as últimas 10 solicitações. O sistema suporta vários formatos de arquivo, incluindo PDF, PNG, JPG, WebP e HEIC de até 50 MB.
O que você pode fazer com ele
- 1Extrair dados de arquivos específicosPeça ao seu assistente para extrair informações de um PDF local usando um template predefinido.
- 2Processamento em lote de pastas de documentosInstrua a IA a ler vários recibos em um diretório e organizar os detalhes em uma tabela.
- 3Monitorar o uso da contaVerifique quantos créditos de página restam na sua conta ParserBee.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP ParserBee
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP ParserBee no Claude Code
$ claude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcpInstalar o MCP ParserBee no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar o MCP ParserBee no VS Code
.vscode/mcp.json
{
"servers": {
"parserbee-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar o MCP ParserBee no VS Code CLI
$ code --add-mcp '{"name":"parserbee-mcp","type":"stdio","command":"npx","args":["-y","parserbee-mcp"],"env":{"PARSERBEE_API_KEY":"<YOUR_PARSERBEE_API_KEY>"}}'Instalar o MCP ParserBee no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Instalar o MCP ParserBee no Codex
$ codex mcp add parserbee-mcp --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' -- npx -y parserbee-mcpInstalar o MCP ParserBee no Codex config.toml
~/.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>"
Instalar o MCP ParserBee no Gemini CLI
$ gemini mcp add -s user -e 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp npx -- -y parserbee-mcpInstalar o MCP ParserBee no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"parserbee-mcp": {
"command": "npx",
"args": [
"-y",
"parserbee-mcp"
],
"env": {
"PARSERBEE_API_KEY": "<YOUR_PARSERBEE_API_KEY>"
}
}
}
}Ferramentas do MCP ParserBee 6
Detectadas a partir do READMEextract_documentlist_templatesget_templateget_creditslist_recent_extractionsget_extraction
| extract_document | — | |
| list_templates | — | |
| get_template | — | |
| get_credits | — | |
| list_recent_extractions | — | |
| get_extraction | — |
Configuração
PARSERBEE_API_KEYObrigatórioSecretoYour ParserBee API key, from Settings in the dashboard
| Nome | Descrição | Tipo |
|---|---|---|
| PARSERBEE_API_KEY | Your ParserBee API key, from Settings in the dashboard | ObrigatórioSecreto |
Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelPassou
- Licença de código aberto (OSI)Passou
- Commit ou release no último anoPassou
- Nome do pacote não é próximo a um pacote popularPassou
- O endpoint remoto usa HTTPSNão verificado
- Ferramentas destrutivas estão rotuladasPassou
- Sem instruções ocultas para o modeloPassou
- Nenhum aviso crítico no pacote ou em suas dependênciasPassou
README
Ver no GitHubParserBee 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
Perguntas sobre o MCP ParserBee
Como adiciono o MCP ParserBee ao Claude Code?
Execute claude mcp add --env 'PARSERBEE_API_KEY=<YOUR_PARSERBEE_API_KEY>' parserbee-mcp -- npx -y parserbee-mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP ParserBee ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP ParserBee oferece?
Ele expõe 6 ferramentas, incluindo extract_document, list_templates, get_template, get_credits, list_recent_extractions.
Quanto custa a extração?
A extração custa 1 crédito de página por página processada.
Quais formatos de arquivo são suportados?
Você pode fazer upload de arquivos PDF, PNG, JPG, WebP ou HEIC de até 50 MB.
Posso usar meus próprios templates?
Sim, o servidor permite que você extraia dados usando seus próprios Parser Templates.