Invoices Generator MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "API_KEY=${API_KEY}" invoices-generator -- uvx --from bach-invoices_generator bach_invoices_generator
Required:API_KEY+ 2 optional
README.md

Access the Invoices Generator API to create professional, customizable invoices.

Invoices Generator MCP Server

English | 简体中文 | 繁體中文

用于访问 Invoices Generator API 的 MCP 服务器。

🚀 使用 EMCP 平台快速体验

EMCP 是一个强大的 MCP 服务器管理平台,让您无需手动配置即可快速使用各种 MCP 服务器!

快速开始:

  1. 🌐 访问 EMCP 平台
  2. 📝 注册并登录账号
  3. 🎯 进入 MCP 广场,浏览所有可用的 MCP 服务器
  4. 🔍 搜索或找到本服务器(bach-invoices_generator
  5. 🎉 点击 "安装 MCP" 按钮
  6. ✅ 完成!即可在您的应用中使用

EMCP 平台优势:

  • 零配置:无需手动编辑配置文件
  • 🎨 可视化管理:图形界面轻松管理所有 MCP 服务器
  • 🔐 安全可靠:统一管理 API 密钥和认证信息
  • 🚀 一键安装:MCP 广场提供丰富的服务器选择
  • 📊 使用统计:实时查看服务调用情况

立即访问 EMCP 平台 开始您的 MCP 之旅!


简介

这是一个 MCP 服务器,用于访问 Invoices Generator API。

  • PyPI 包名: bach-invoices_generator
  • 版本: 1.0.0
  • 传输协议: stdio

安装

从 PyPI 安装:

pip install bach-invoices_generator

从源码安装:

pip install -e .

运行

方式 1: 使用 uvx(推荐,无需安装)

# 运行(uvx 会自动安装并运行)
uvx --from bach-invoices_generator bach_invoices_generator

# 或指定版本
uvx --from bach-invoices_generator@latest bach_invoices_generator

方式 2: 直接运行(开发模式)

python server.py

方式 3: 安装后作为命令运行

# 安装
pip install bach-invoices_generator

# 运行(命令名使用下划线)
bach_invoices_generator

配置

API 认证

此 API 需要认证。请设置环境变量:

export API_KEY="your_api_key_here"

环境变量

变量名 说明 必需
API_KEY API 密钥
PORT 不适用
HOST 不适用

在 Cursor 中使用

编辑 Cursor MCP 配置文件 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-invoices_generator": {
      "command": "uvx",
      "args": ["--from", "bach-invoices_generator", "bach_invoices_generator"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件 claude_desktop_config.json:

{
  "mcpServers": {
    "bach-invoices_generator": {
      "command": "uvx",
      "args": ["--from", "bach-invoices_generator", "bach_invoices_generator"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

此服务器提供以下工具:

`generate_invoice`

Quickly generate invoices through a REST API endpoint

端点: GET /generate-invoice

参数:

  • number (string) 必需: Represents the invoice number

  • buyer_company_name (string) 必需: The company name of the buyer entity. It can also be just a simple name of a person in case the buyer is not a company.

  • buyer_tax_number (string): The tax number of the buyer's company. This field is not mandatory.

  • buyer_vat_number (string): The VAT number of the buyer's company. This field is not mandatory.

  • buyer_address (string): The address of the buyer entity. This field is not mandatory.

  • seller_company_name (string) 必需: The company name of the seller entity. This can be a person's name as well, in case the seller is not a company.

  • seller_tax_number (string): The tax number of the seller's company. This field is not mandatory.

  • seller_vat_number (string): The VAT number of the seller's company. This field is not mandatory.

  • seller_address (string): The address of the seller. This field is not mandatory.

  • seller_bank_name (string): The bank name of the account of the seller. This field is not mandatory.

  • seller_bank_account (string): The bank account of the seller, where the payment will be made. This field is not mandatory.

  • services (string) 必需: A JSON representing the services, and their prices that will be written on the invoice. The JSON is using the following format: [{\\\"name\\\": \\\"My Service\\\", \\\"price\\\": \\\"30\\\", \\\"units\\\": \\\"Hours\\\", \\\"discount\\\": \\\"1000\\\", \\\"quantity\\\": \\\"1000\\\"}] The JSON is an array. Each element of the array represents a service. Each service is a JSON object with the following properties: nam

  • tax (number) 必需: The tax percentage aplied to the invoice.

  • shipping (number): The amount to be paid for shipping. This field is not mandatory.

  • service_fee (number): A service fee to add on the invoice. This field is not mandatory.

  • currency (string) 必需: The currency in which the prices will be shown on the invoices. It can be any 3 letter currency code. If the code is not recognized then it will be simply displayed directly.

  • date (string) 必需: The date of the invoice

  • due_date (string): The due date of the invoice. This field is not mandatory.

  • logo (string): A logo to display on the top left corner of the invoice. This field is not mandatory.

  • locale (string): The language of the invoice. Accepted languages are: 'en' => 'English', 'nl' => 'Dutch', 'de' => 'German', 'es' => 'Spanish', 'fr' => 'French', 'it' => 'Italian', 'pl' => 'Polish', 'pt_BR' => 'Brazilian Portuguese', 'ro' => 'Romanian',


技术栈

  • 传输协议: stdio
  • HTTP 客户端: httpx

许可证

Tools (1)

generate_invoiceQuickly generate invoices through a REST API endpoint

Environment Variables

API_KEYrequiredAPI key for authenticating with the Invoices Generator service
PORTNot applicable
HOSTNot applicable

Configuration

claude_desktop_config.json
{"mcpServers": {"bach-invoices_generator": {"command": "uvx", "args": ["--from", "bach-invoices_generator", "bach_invoices_generator"], "env": {"API_KEY": "your_api_key_here"}}}}

Try it

Generate an invoice for company 'Tech Solutions' for 10 hours of consulting at $100/hour, due in 30 days.
Create a professional invoice for my services provided to 'Global Corp' with a 5% tax rate in USD.
Generate a German-language invoice for 'Schmidt GmbH' including bank details and a service fee of $50.
Create an invoice for a project with multiple line items including design, development, and testing services.

Frequently Asked Questions

What are the key features of Invoices Generator?

Generate professional, customizable invoices via REST API. Support for multiple languages and currency codes. Configurable tax, shipping, and service fee fields. Detailed buyer and seller information management. Standardized JSON interface for service line items.

What can I use Invoices Generator for?

Automating the billing process for freelance consulting work. Generating localized invoices for international clients. Integrating invoice creation directly into AI-assisted project management workflows. Standardizing invoice generation across different business entities.

How do I install Invoices Generator?

Install Invoices Generator by running: pip install bach-invoices_generator

What MCP clients work with Invoices Generator?

Invoices Generator works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Invoices Generator docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare