fakturka-api-mcp
Faktuj MCP 服务器
将 Faktuj 集成到 Claude、Cursor、VS Code 以及任何兼容 MCP 的 AI 助手。生成 增值税发票 和 形式发票,通过 NIP 查询公司信息,查看波兰国家银行 (NBP) 汇率,并验证 IBAN 号码——所有操作均可在您的 AI 工作流中完成。完全符合 KSeF 合规性 要求。
无需 API 密钥。永久免费。
快速开始
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"faktuj": {
"command": "npx",
"args": ["-y", "faktuj-mcp"]
}
}
}或者全局安装:
npm install -g faktuj-mcp然后添加到您的配置中:
{
"mcpServers": {
"faktuj": {
"command": "faktuj-mcp"
}
}
}Related MCP server: mcp-ksef-pl
可用工具
工具 | 描述 |
| 生成波兰 增值税发票 PDF。传入包含卖方、买方和明细项的完整发票 JSON。返回发票号码和 base64 格式的 PDF。 |
| 生成 形式发票 PDF。架构与增值税发票相同。返回发票号码和 base64 格式的 PDF。 |
| 预览并验证发票数据,无需生成 PDF。返回验证后的数据或验证错误。 |
| 通过 NIP 税号查询波兰公司。返回公司名称、地址和注册数据。 |
| 查询给定货币和日期的波兰国家银行 (NBP) 汇率。 |
| 验证 IBAN 号码。如果有效,返回验证结果和银行详细信息。 |
使用示例
询问您的 AI 助手:
“生成一张从 ACME sp. z o.o. (NIP: 1234567890) 开给 Beta S.A. 的增值税发票,内容为 10 小时咨询服务,单价 200 PLN/小时”
“查询 NIP 为 5263442510 的公司”
“2026-03-20 的 EUR/PLN 汇率是多少?”
“验证 IBAN PL61109010140000071219812874”
架构
AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API这是一个基于 Faktuj REST API 的轻量级 stdio MCP 传输层。MCP 服务器将工具调用转换为 HTTP 请求并返回结构化响应。
配置
环境变量 | 默认值 | 描述 |
|
| Faktuj API 的基础 URL |
资源
增值税发票指南 — 如何创建合规的波兰增值税发票
形式发票指南 — 何时以及如何使用形式发票
KSeF 合规性 — 波兰国家电子发票系统要求
博客 — 发票指南、税务建议和产品更新
API 文档 — 完整的 REST API 参考
SoftVoyagers 生态系统
Faktuj 是 SoftVoyagers 开源项目组合的一部分:
产品 | 描述 | 网站 |
LinkMeta | 免费 URL 元数据提取 API | |
PageShot | 免费截图和网页捕获 API | |
PDFSpark | 免费 HTML/URL 转 PDF 转换 API | |
OGForge | 免费 Open Graph 图像生成 API | |
LinkShrink | 免费隐私优先的 URL 缩短 API | |
Faktuj | 免费波兰增值税发票生成器 | |
QRMint | 免费样式化二维码生成器及 API | |
PageDrop | 免费即时 HTML 托管 API | |
PismoSzyteNaMiarę | Darmowy generator pism urzędowych |
许可证
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Free Polish VAT invoice generator API (Faktura VAT). Generate professional PDF invoices with light/dark themes. No API keys required.
Fakturownia.pl (Polish invoicing) via MCP: invoices, clients, products, warehouse. Full read-write.
wFirma.pl (Polish accounting) via MCP: invoices, contractors, payments, reports. Full read-write.
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.645 npm2MIT
- AlicenseAqualityCmaintenanceModel Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.103Apache 2.0
- FlicenseBqualityCmaintenanceSingle-tenant MCP server for Polish KSeF e-invoice workflows, supporting local stdio testing, draft management, and invoice submission with safety gates.23-
- AlicenseNot gradedqualityDmaintenanceMCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.48 npmMIT