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.txt2.获取API凭据
- 登录 超级阿库拉
- 首选 工具 → API
- 复制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______________________________________________________________________
文档
______________________________________________________________________
可用工具
发票（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 参考 详细文档。
______________________________________________________________________
国家支持
| 国家 | 代码 | URL |
|---|---|---|
| 斯洛伐克 | sk | 我的.superfaktura.sk |
| 捷克共和国 | cz | 我的.superfaktura.cz |
| 奥地利 | at 我的.superfaktura.at | |
| 沙箱（SK） | sandbox-sk | sandbox.sperfection.Sk |
| 沙箱（CZ） | sandbox-cz | sandbox.superfak.cz |
______________________________________________________________________
发展
运行服务器：
python server.pyMCP检验员测试：
npx @modelcontextprotocol/inspector python server.py______________________________________________________________________
参考文献
实施基于：
______________________________________________________________________
许可证
阿帕奇-2.0
贡献
欢迎捐款。提交问题或撤回改进请求。