BuchhaltungsButler MCP-Server

一个用于 BuchhaltungsButler API 的 Model Context Protocol (MCP) 服务器。你可以通过它直接在 Claude Desktop、ChatGPT 或任何其他 MCP 客户端中使用 BuchhaltungsButler。

前提条件

• Node.js ≥ 18

• BuchhaltungsButler API 访问权限（API Client + API Secret + 客户的 API Key）

Related MCP server: MonKey Office MCP Server

安装

git clone <repo-url>
cd buchhaltungsbutler-mcp
npm install
npm run build

配置

需要以下环境变量：

可选：

在 Claude Desktop 中使用

1. 打开 Claude Desktop 配置：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 添加服务器：

{
  "mcpServers": {
    "buchhaltungsbutler": {
      "command": "node",
      "args": ["/absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js"],
      "env": {
        "BUCHHALTUNGSBUTLER_API_CLIENT": "dein-api-client",
        "BUCHHALTUNGSBUTLER_API_SECRET": "dein-api-secret",
        "BUCHHALTUNGSBUTLER_API_KEY": "kunden-api-key"
      }
    }
  }
}

3. 重新启动 Claude Desktop。

在 ChatGPT / 其他客户端中使用

此服务器使用 MCP-Stdio 传输，Claude Desktop 原生支持该传输。对于 ChatGPT 或其他客户端，需要 MCP 客户端桥接器（例如 mcp-proxy）来将 Stdio 转换为 SSE/WebSocket：

npx mcp-proxy node /absoluter/pfad/zu/buchhaltungsbutler-mcp/dist/index.js

可用工具

• 凭证：list_receipts、get_receipt、create_receipt、upload_receipt、delete_receipt

• 交易：list_transactions、get_transaction、create_transaction、assign_receipt_to_transaction、unassign_receipt_from_transaction

• 发票：create_invoice、create_invoice_draft

• 记账：list_postings、create_free_posting

• 主数据：list_debtors、list_creditors、list_posting_accounts、create_debtor、create_creditor

• 其他：list_accounts、add_comment、list_cost_locations、create_cost_location

完整的 API 文档以 api-spec.json 形式存放在项目中，可与官方 BuchhaltungsButler API-Docs 进行对照。

安全性

• API Client 和 Secret 是机密信息。请勿将其存储在仓库中，而应仅存储在 Claude Desktop 配置或环境变量中。

• .gitignore 排除了 node_modules/、dist/ 和 .env。

开发

npm run dev     # TypeScript im Watch-Modus
npm run build   # Einmalig bauen
npm start       # Server starten

许可证

MIT