发票管理服务器

Superfakura MCP服务器

SuperFaktura发票系统的模型上下文协议（MCP）服务器。使人工智能助手能够与SuperFaktura API交互，以管理发票、客户和费用。

作者 @菲利普菲利普95

特性

• 发票管理 -使用40+个参数创建、列出、编辑、删除、发送发票
• 客户管理 -30多个字段的完整CRUD操作
• 费用管理 -使用文件附件完成费用跟踪
• 高级过滤 -25+发票过滤选项，全面搜索所有资源
• 多租户支持 -部署为公共MCP服务器或在本地运行

快速开始

1.安装

git clone https://github.com/digitaliko/superfaktura-mcp.git
cd superfaktura-mcp
pip install -r requirements.txt

2.获取API凭据

1. 登录 超级阿库拉
2. 首选 工具 → API
3. 复制API密钥

3.配置克劳德桌面

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "superfaktura": {
      "command": "python3",
      "args": ["/absolute/path/to/superfaktura-mcp/server.py"],
      "env": {
        "SUPERFAKTURA_EMAIL": "your-email@example.com",
        "SUPERFAKTURA_API_KEY": "your-api-key-here",
        "SUPERFAKTURA_COUNTRY": "sk"
      }
    }
  }
}

配置后重新启动Claude Desktop。

使用示例

创建发票：

Create an invoice for client ID 123 with items:
- Web design (€500)
- Hosting (€50/month)

列出未付发票：

Show me all unpaid invoices from last month with amounts over €1000

添加客户端：

Add a new client: ACME Corp, email: billing@acme.com, IČO: 12345678

跟踪支出：

Record an expense: Office supplies €150 from yesterday

文档

• API 参考 -所有工具和参数的完整列表
• 部署指导 -本地和公共MCP服务器部署选项

可用工具

发票（9个工具）

create_invoice, list_invoices, get_invoice, edit_invoice, delete_invoice, send_invoice, mark_invoice_paid, get_invoice_pdf, set_invoice_language

客户端（5个工具）

create_client, list_clients, get_client, update_client, delete_client

费用（5个工具）

create_expense, list_expenses, get_expense, edit_expense, delete_expense

看 API 参考 详细文档。

国家支持

发展

运行服务器：

python server.py

MCP检验员测试：

npx @modelcontextprotocol/inspector python server.py

参考文献

实施基于：

• SuperFaktura API官方客户端
• 这是一个超级库休息API文档
• OpenAPI规范 通过 @克斯曼

许可证

阿帕奇-2.0

贡献

欢迎捐款。提交问题或撤回改进请求。