内容
# Faktuj MCP 服务器
[](https://www.npmjs.com/package/faktuj-mcp)
[](https://faktuj.pl)
[](https://faktuj.pl/health)
将 **[Faktuj](https://faktuj.pl)** 集成到 Claude, Cursor, VS Code 和任何与 MCP 兼容的 AI 助手。生成 [增值税发票](https://faktuj.pl/faktura-vat) 和 [预发票](https://faktuj.pl/faktura-proforma)，查找公司税号，查询 NBP 汇率，并验证 IBAN 号码 — 所有这些都可以在您的 AI 工作流中完成。完全符合 [KSeF 合规性](https://faktuj.pl/ksef) 要求。
无需 API 密钥。永久免费。
## 快速开始
将以下内容添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"faktuj": {
"command": "npx",
"args": ["-y", "faktuj-mcp"]
}
}
}
```
或全局安装：
```bash
npm install -g faktuj-mcp
```
然后将以下内容添加到您的配置中：
```json
{
"mcpServers": {
"faktuj": {
"command": "faktuj-mcp"
}
}
}
```
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `generate_invoice` | 生成波兰 [增值税发票](https://faktuj.pl/faktura-vat) PDF。传递完整的发票 JSON，包括卖方、买方和行项目。返回发票号码和 base64 PDF。 |
| `generate_proforma` | 生成 [预发票](https://faktuj.pl/faktura-proforma) PDF。与增值税发票相同的架构。返回发票号码和 base64 PDF。 |
| `preview_invoice` | 预览和验证发票数据，而不生成 PDF。返回验证的数据或验证错误。 |
| `lookup_nip` | 通过税号查找波兰公司。返回公司名称、地址和注册数据。 |
| `lookup_nbp_rate` | 查询给定货币和日期的 NBP（波兰国家银行）汇率。 |
| `validate_iban` | 验证 IBAN 号码。返回验证结果和银行详细信息（如果有效）。 |
## 示例用法
询问您的 AI 助手：
- *"为 ACME sp. z o.o.（税号：1234567890）生成一张增值税发票，发票内容为 Beta S.A. 10 小时的咨询服务，费用为 200 PLN/h"*
- *"查找税号为 5263442510 的公司"*
- *"2026-03-20 的 EUR/PLN 汇率是多少？"*
- *"验证 IBAN PL61109010140000071219812874"*
## 架构
```
AI 助手 <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API
```
这是一个薄的 stdio MCP 传输层，位于 [Faktuj REST API](https://faktuj.pl/docs) 之上。MCP 服务器将工具调用转换为 HTTP 请求，并返回结构化的响应。
## 配置
| 环境变量 | 默认值 | 描述 |
|---------------------|---------|-------------|
| `FAKTUJ_API_URL` | `https://faktuj.pl` | Faktuj API 的基本 URL |
## 资源
- [增值税发票指南](https://faktuj.pl/faktura-vat) — 如何创建合规的波兰增值税发票
- [预发票指南](https://faktuj.pl/faktura-proforma) — 何时以及如何使用预发票
- [KSeF 合规性](https://faktuj.pl/ksef) — 波兰国家电子发票系统要求
- [博客](https://faktuj.pl/blog) — 发票指南、税务提示和产品更新
- [API 文档](https://faktuj.pl/docs) — 完整的 REST API 参考
## SoftVoyagers 生态系统
Faktuj 是 [SoftVoyagers](https://github.com/softvoyagers) 开源投资组合的一部分：
| 产品 | 描述 | 网站 |
|---------|-------------|---------|
| **LinkMeta** | 免费 URL 元数据提取 API | [linkmeta.dev](https://linkmeta.dev) |
| **PageShot** | 免费截图和网页捕获 API | [pageshot.site](https://pageshot.site) |
| **PDFSpark** | 免费 HTML/URL 转 PDF 转换 API | [pdfspark.dev](https://pdfspark.dev) |
| **OGForge** | 免费 Open Graph 图片生成 API | [ogforge.dev](https://ogforge.dev) |
| **LinkShrink** | 免费隐私优先 URL 缩短 API | [linkshrink.dev](https://linkshrink.dev) |
| **Faktuj** | 免费波兰增值税发票生成器 | [faktuj.pl](https://faktuj.pl) |
| **QRMint** | 免费样式化二维码生成器和 API | [qrmint.dev](https://qrmint.dev) |
| **PageDrop** | 免费即时 HTML 托管 API | [pagedrop.dev](https://pagedrop.dev) |
| **PismoSzyteNaMiarę** | 免费官方文件生成器 | [pismoszytenamiare.pl](https://pismoszytenamiare.pl) |
## 许可证
MIT
