eqvitta-mcp

Eqvitta 会计 MCP 服务

适用于 Eqvitta Cloud Accounting & GST Billing 的官方 Model Context Protocol (MCP) 服务。

将 Claude Desktop、Claude Code 以及任何兼容 MCP 的 AI 客户端直接连接到您的 Eqvitta 会计记录。轻松生成 GST 销售和采购发票、管理分类账、登记收款和付款、查询试算平衡表，并通过严格的基于角色的数据隔离对账财务报表。

---

⚡ 使用 Claude Desktop 快速开始

自动一键安装（Smithery）

如果使用 Smithery：

npx -y @smithery/cli install eqvitta-mcp --client claude

---

手动配置

将服务添加到您的 claude_desktop_config.json：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "eqvitta": {
      "command": "npx",
      "args": ["-y", "github:Eqvitta/eqvitta-mcp"],
      "env": {
        "EQVITTA_API_KEY": "YOUR_EQVITTA_API_KEY_HERE"
      }
    }
  }
}

如何获取 API Key：登录 Eqvitta > Settings > API Keys > 生成新的 Key。

---

🚀 主要功能

• GST 开票：
  • 自动计算 CGST、SGST、IGST 和舍入金额。
  • 自动分配下一个连续发票编号（例如 NR/2627/005）。
  • 即时创建平衡的复式分类账分录。
• 分类账和账户组：
  • 查询分类账、未结余额、往来方联系方式和账户组结构。
• 凭证和交易：
  • 针对客户、供应商和费用分类账记录银行／现金收款和付款。
  • 记录服务销项和进项发票。
• 实时财务报告：
  • 即时获取试算平衡表、损益汇总和分类账账户报表。
• 基于角色的安全性：
  • 多租户隔离。所有操作均限定于 API Key 用户所属的公司。
  • 通过 MCP 严格禁用破坏性操作（编辑和删除）。
  • 内部分类账转账和财务调整需要更高的管理权限（financialreporteditor 或 company_admin）。

---

🛠️ 可用的 MCP 工具

类别	工具	描述
公司和分类账	list_companies, search_ledgers, get_ledger_balance, get_ledger_statement, update_ledger_contact	浏览公司、查询余额并查看报表分录。
库存和目录	search_stocks, get_stock_detail, search_account_groups	搜索库存项目、数量、HSN/SAC 代码和会计组。
开票	create_sales_invoice, create_purchase_invoice, create_service_outward, create_service_inward, create_logistic_invoice	生成符合 GST 规定的销售、采购、服务和货运凭证。
收款和付款	create_receipt_voucher, create_payment_voucher	通过银行／现金账户记录客户付款和供应商付款。
财务报告	get_trial_balance, get_financial_statement	获取结构化的资产负债表和损益数据。
送货单	search_challans, get_challan_detail	跟踪交付和运输送货单。
管理转账 (受限)	transfer_ledger_journal, transfer_group_balances_journal, bulk_transfer_transactions_ledger	调整分类账分录并转移余额（仅对获授权角色可见）。

---

🔒 安全与架构

eqvitta-mcp CLI 连接到 Eqvitta 的高可用远程引擎（https://chatapi.eqvitta.com/webhook/mcp）。

• 零本地维护：所有架构变更和会计规则更新都由云端引擎管理。客户端无需手动更新版本。
• 加密通信：所有流量均通过 TLS 1.3 加密。
• 最小权限：仅向 AI 模型开放用户角色授权的工具。

---

📄 许可证

MIT 许可证。版权所有 (c) 2026 Eqvitta Software Solutions。