AI导哈

发票管理服务器

为波兰会计API iFirma.pl提供的MCP服务器，支持通过自然语言管理发票、费用、承包商等财务操作。

  • by adriandmitroca
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 adriandmitroca/ifirma-mcp-server

使用说明

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密钥

  1. 登录到 iforma.pl
  2. 首选 设置>API
  3. 为Faktura、Wydatek、Abonent生成密钥
  4. 将十六进制键复制到环境变量中

环境变量

变量 必填 描述
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 按键）

工具 说明
create_order 创建电子商务订单

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 了解更多详情。

许可证

麻省理工学院

相关 MCP