内容
# Invovate MCP 服务器
[](https://www.npmjs.com/package/invovate-mcp-server)
[](https://registry.modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/LightSpeedPlusOne/invovate-mcp-server)
[](https://invovate.com/openapi.json)
[](LICENSE)
**Invovate MCP 服务器是一个免费、无需注册的发票 MCP 服务器，适用于 Claude、Cursor 和其他 MCP 客户端 — 它通过 [Invovate 发票 API](https://invovate.com/api) 生成 PDF、JSON 和 UBL 2.1 格式的发票。**
让 AI 代理通过 [Invovate 发票 API](https://invovate.com/api) 生成 **PDF、JSON 和 UBL 2.1 格式的发票，支持 11 种语言**（包括从右到左的阿拉伯语、日语、印地语和西里尔字母）。与 Claude Desktop、Cursor、Windsurf 和任何支持 [MCP](https://modelcontextprotocol.io) 的客户端兼容。
JSON 数学运算无需 API 密钥；PDF/UBL 输出需要免费密钥。
## 工具
| 工具 | 功能 | 是否需要密钥 |
|------|--------|------------|
| `calculate_invoice_totals` | 计算子总计、折扣、税、运费、押金、总计、余额 — 不生成文件 | 否 |
| `generate_invoice_pdf` | 生成 PDF。返回 7 天的托管链接（适用于聊天），或在提供 `save_path` 时写入文件 | 是 |
| `generate_invoice_ubl` | 生成 UBL 2.1 XML（仅用于互操作性/存档 — *不是* 受监管的电子发票） | 是 |
| `get_invoice_capabilities` | 列出支持的语言、模板、货币和功能 | 否 |
## 获取免费 API 密钥
在 **https://invovate.com/auth** 注册 — 您的密钥以 `inv_` 开头。免费层，无需信用卡。（`calculate_invoice_totals` 无需密钥；PDF、UBL、二维码和托管链接需要免费密钥。）
## 安装
### Claude Desktop
添加到 `claude_desktop_config.json`
（macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`，Windows：`%APPDATA%\Claude\claude_desktop_config.json`）：
```json
{
"mcpServers": {
"invovate": {
"command": "npx",
"args": ["-y", "invovate-mcp-server"],
"env": { "INVOVATE_API_KEY": "inv_您的密钥" }
}
}
}
```
重启 Claude Desktop。然后询问：*“为 Acme BV 创建发票，账单对象为 Globex，3 个咨询日，每日 €900，含 21% 增值税，语言为英文，并提供 PDF。”*
### Cursor / Windsurf
将相同的块添加到 MCP 配置（Cursor：`~/.cursor/mcp.json`，或 Windsurf 的 MCP 设置）。
### 从源码运行（npm 发布前）
```bash
git clone https://github.com/LightSpeedPlusOne/invovate-mcp-server.git
cd invovate-mcp-server && npm install
INVOVATE_API_KEY=inv_您的密钥 node src/index.js
```
… 并指向您的客户端：
```json
{
"mcpServers": {
"invovate": {
"command": "node",
"args": ["/绝对路径/to/mcp-server/src/index.js"],
"env": { "INVOVATE_API_KEY": "inv_您的密钥" }
}
}
}
```
## 配置
| 环境变量 | 默认值 | 用途 |
|---------|---------|---------|
| `INVOVATE_API_KEY` | — | 免费 API 密钥（`inv_…`）。启用 PDF/UBL 输出和托管链接。 |
| `INVOVATE_API_BASE` | `https://invovate.com` | 覆盖 API 基址（很少需要）。 |
## 测试
```bash
npm test # 列出工具 + JSON 数学运算（无需密钥）
INVOVATE_API_KEY=inv_xxx npm test # 还测试 PDF 托管链接路径
```
## 注意事项
- **不是受监管的电子发票。** UBL 导出仅用于互操作性/存档。 不符合 Peppol / Factur-X / ZUGFeRD / XRechnung / NF-e 规范或网络交付。
- 托管链接过期，发票在 7 天后删除。
- 代理文档：https://invovate.com/invoice-api-for-ai-agents · OpenAPI：https://invovate.com/openapi.json
## 示例提示
连接后，以自然语言询问 AI 客户端：
```text
为 Acme Ltd 创建发票，3 小时咨询费，每小时 $120。返回 PDF。
为 SaaS 订阅生成 UBL 2.1 发票，月费 €49。
为日语发票（日元）生成 ¥350,000 网络设计费，含 10% 消费税，并提供链接。
```
## 链接
- **发票 API 及文档：** https://invovate.com/api · https://invovate.com/invoice-api-for-ai-agents
- **OpenAPI 3.1 规范：** https://invovate.com/openapi.json （导入为 ChatGPT / Claude Action）
- **MCP 主页：** https://invovate.com/mcp-invoice-generator · **所有集成：** https://invovate.com/integrations
- **npm（此软件包）：** https://www.npmjs.com/package/invovate-mcp-server
- **Python SDK：** https://pypi.org/project/invovate/ · **JavaScript SDK：** https://www.npmjs.com/package/invovate
- **Glama MCP 目录：** https://glama.ai/mcp/servers/LightSpeedPlusOne/invovate-mcp-server
- **Postman 集合：** https://www.postman.com/lightspeedplusone-9440989/workspace/invovate-invoice-api/overview
- **RapidAPI：** https://rapidapi.com/LightSpeedPlusOne/api/invovate-invoice
- **WordPress 插件：** https://wordpress.org/plugins/invovate-invoice-generator/
## 许可证
MIT © Invovate
