AI导哈

发票管理MCP服务器

Billingo MCP服务器是一个用于匈牙利Billingo V3发票API的MCP服务器，支持从任何MCP客户端管理发票、合作伙伴、产品、支出和银行账户。

  • by bartadaniel
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bartadaniel/billingo-mcp

使用说明

billingo-mcp

MCP server for the Billingo V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.

Quick Start

  1. Get your API key from Billingo API settings

  2. Add to your Claude Code settings (~/.claude/settings.json) or Claude Desktop config:

{
  "mcpServers": {
    "billingo": {
      "command": "npx",
      "args": ["-y", "@daniel.barta/billingo-mcp"],
      "env": {
        "BILLINGO_API_KEY": "your-api-key"
      }
    }
  }
}
  1. Restart Claude and start managing your invoices.

Configuration

Environment Variable Required Default Description
BILLINGO_API_KEY Yes -- Your Billingo API key
BILLINGO_MOCK No false Set to true for mock mode (no API calls)

Mock mode is activated automatically when no API key is provided, or explicitly with BILLINGO_MOCK=true. Useful for development and testing.

Tools

Documents

Tool Description
list_documents List invoices with filters (partner, status, date range, type, payment method)
create_document Create invoices, proformas, advance invoices, or drafts
get_document Get document details by ID
cancel_document Cancel (storno) a document
send_document Send document via email
download_document Download document as PDF
get_document_public_url Get public URL for a document
update_payment Record or update payment on a document

Partners

Tool Description
list_partners List partners with search
create_partner Create a new partner (with address, tax info)
get_partner Get partner details by ID
update_partner Update an existing partner

Products

Tool Description
list_products List products
create_product Create a new product
get_product Get product details by ID
update_product Update an existing product

Spendings

Tool Description
list_spending List spendings with filters
create_spending Create a spending entry (with line items and VAT)
get_spending Get spending details by ID

Bank Accounts

Tool Description
list_bank_accounts List bank accounts
create_bank_account Create a new bank account
get_bank_account Get bank account details by ID
update_bank_account Update an existing bank account

Utilities

Tool Description
check_tax_number Validate a Hungarian tax number via NAV
get_organization Get your own organization data
get_currency_rates Get exchange rates
list_document_blocks List invoice numbering sequences

Development

git clone https://github.com/bartadaniel/billingo-mcp.git
cd billingo-mcp
npm install
npm run build

Use the local build in your config:

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["path/to/billingo-mcp/bin/billingo-mcp.js"],
      "env": {
        "BILLINGO_API_KEY": "your-api-key"
      }
    }
  }
}

Mock Mode

Run without an API key for development:

npm run dev

This starts the server with BILLINGO_MOCK=true, returning realistic fixture data for all tools.

License

MIT

相关 MCP