ifirma-mcp服务器
MCP服务器 iFirma.pl 波兰会计API。使AI助手（Claude、Cursor、Windsurf）能够通过自然语言管理发票、费用、承包商等。
设置
克劳德代码
claude mcp add ifirma \
-e IFIRMA_USERNAME=your@email.pl \
-e IFIRMA_API_KEY_INVOICE=hex_key_faktura \
-e IFIRMA_API_KEY_EXPENSE=hex_key_wydatek \
-e IFIRMA_API_KEY_ACCOUNT=hex_key_abonent \
-e IFIRMA_API_KEY_RECEIPT=hex_key_rachunek \
-- npx -y ifirma-mcp-server
克劳德桌面版
添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：
{
"mcpServers": {
"ifirma": {
"command": "npx",
"args": ["-y", "ifirma-mcp-server"],
"env": {
"IFIRMA_USERNAME": "your@email.pl",
"IFIRMA_API_KEY_INVOICE": "hex_key_faktura",
"IFIRMA_API_KEY_EXPENSE": "hex_key_wydatek",
"IFIRMA_API_KEY_ACCOUNT": "hex_key_abonent",
"IFIRMA_API_KEY_RECEIPT": "hex_key_rachunek"
}
}
}
}
其他MCP客户端
运行通过 npx -y ifirma-mcp-server 环境变量如下。
API密钥
- 登录到 iforma.pl
- 首选 设置>API
- 为Faktura、Wydatek、Abonent生成密钥
- 将十六进制键复制到环境变量中
环境变量
| 变量 | 必填 | 描述 |
|---|
IFIRMA_USERNAME | 是 | ifirma登录（电子邮件） |
IFIRMA_API_KEY_INVOICE | 发票没有\* | API密钥(faktura) |
IFIRMA_API_KEY_EXPENSE | 无\* | API费用密钥(wydatek) |
IFIRMA_API_KEY_ACCOUNT | 没有用于帐户操作的\* | API密钥(abonent) |
IFIRMA_API_KEY_RECEIPT | 收据没有\* | API密钥(rachunek) |
IFIRMA_DRY_RUN | 否 | 测试模式--记录请求而不发送 |
\*至少需要一个API密钥。
可用工具
发票(faktura 按键）
| 工具 | 说明 |
|---|
list_invoices | 用过滤器列出已开具的发票 |
create_domestic_invoice | 国内增值税发票 |
create_domestic_invoice_non_vat | 非增值税纳税人的国内发票 |
create_proforma | 形式发票 |
create_export_invoice | 出口发票 |
create_wdt_invoice | 社区内部供应（WDT）发票 |
create_eu_service_invoice | 欧盟服务发票（第28b条） |
create_foreign_currency_invoice | 外币发票 |
create_correction_invoice | 更正发票 |
create_receipt_invoice | 收据发票（faktura do paragonu） |
create_oss_invoice | 一站式发票 |
create_ioss_invoice | 进口一站式发票 |
send_invoice_email | 通过电子邮件发送发票 |
send_invoice_post | 通过邮政邮件发送发票 |
send_invoice_ksef | 向KSeF提交发票 |
承包商(faktura 按键）
| 工具 | 说明 |
|---|
search_contractors | 按姓名或NIP搜索 |
get_contractor | 按ID列出的承包商详细信息 |
create_contractor | 添加新承包商 |
update_contractor | 更新承包商（需要所有字段） |
付款(faktura 按键）
| 工具 | 说明 |
|---|
register_payment | 根据发票登记付款 |
增值税税率(faktura 按键）
| 工具 | 说明 |
|---|
get_eu_vat_rates | 按国家代码列出的欧盟增值税税率 |
费用(wydatek 按键）
| 工具 | 说明 |
|---|
create_cost_expense | 含增值税发票的业务成本 |
create_goods_purchase_expense | 物资采购 |
create_other_cost_expense | 非发票成本（收据、合同等） |
create_telecom_expense | 电话/互联网费用 |
账户abonent 按键）
| 工具 | 说明 |
|---|
get_accounting_month | 当前会计月份 |
set_accounting_month | 更改会计月份 |
get_api_limits | 检查API费率限制 |
订单(abonent 按键）
HR(abonent 按键）
| 工具 | 说明 |
|---|
manage_employee_questionnaire | 员工个人问卷 |
发展
git clone https://github.com/adriandmitroca/ifirma-mcp-server.git
cd ifirma-mcp-server
npm install
npm run dev
npm test # Unit tests (no API access needed)
IFIRMA_DRY_RUN=true npm run dev # Dry-run mode
看 贡献.md 了解更多详情。
许可证
麻省理工学院
