MCP Lexware Office

🚀 Lexware Office MCP 服務器

Lexware Office MCP 服務器是一個集成了 Lexware Office（前稱為 Lexoffice）的 MCP 服務器實現。它通過模型上下文協議提供無縫接口，可用於管理企業的各類業務操作，為企業業務管理提供便利。

✨ 主要特性

• Lexware Office 集成：能夠直接與 Lexware Office API 進行集成，實現數據的交互與同步。
• 企業管理：可對發票、聯繫人和其他業務文檔進行管理，不過目前僅支持只讀操作。

📦 安裝指南

獲取 Lexware Office API 密鑰

訪問 https://app.lexoffice.de/addons/public-api 即可獲取您的 API 密鑰。

先決條件

• 需要安裝 Node.js 22 或更高版本。

使用 Claude Desktop

將以下內容添加到 claude_desktop_config.json 文件中：

{
    "mcpServers": {
        "mcp-lexware-office": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "-e", "LEXWARE_OFFICE_API_KEY", "mcp-lexware-office"],
            "env": {
                "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

使用 NPX

{
    "mcpServers": {
        "mcp-lexware-office": {
            "command": "npx",
            "args": ["-y", "JannikWempe/mcp-lexware-office"],
            "env": {
                "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

💻 使用示例

工具說明

以下工具可通過此 MCP 服務器使用：

get-invoices

• 功能：獲取 Lexware Office 中的發票列表。
• 輸入參數：
  • status (字符串數組，可選)：可按狀態過濾（"open", "draft", "paid", "paidoff", "voided"），默認獲取所有狀態的發票。
  • page (數字，可選)：要獲取的頁碼（從 0 開始），默認頁碼為 0。
  • size (數字，可選)：每頁顯示的發票數量（範圍為 1 - 250），默認每頁顯示 250 條。

get-invoice-details

• 功能：獲取 Lexware Office 中某個發票的詳細信息。
• 輸入參數：
  • id (字符串)：發票的 UUID。

get-contacts

• 功能：按條件獲取 Lexware Office 中的聯繫人，支持邏輯與的多個過濾器。
• 輸入參數：
  • email (字符串，可選)：按電子郵件地址過濾（支持通配符）。
  • name (字符串，可選)：按名稱過濾（支持通配符）。
  • number (數字，可選)：按聯繫人編號過濾。
  • customer (布爾值，可選)：按客戶角色過濾。
  • vendor (布爾值，可選)：按供應商角色過濾。
  • page (數字，可選)：要獲取的頁碼（從 0 開始），默認頁碼為 0。
  • size (數字，可選)：每頁顯示的聯繫人數量（範圍為 1 - 250），默認每頁顯示 250 條。

list-posting-categories

• 功能：獲取會計憑證使用的分錄類別的列表。
• 輸入參數：
  • type (字符串，可選)：按類別類型過濾（"income" 或 "outgo"）。

list-countries

• 功能：獲取 Lexware Office 中已知的國家及其稅收分類信息。
• 輸入參數：
  • taxClassification (字符串，可選)：按稅收分類過濾（"de" 表示德國，"intraCommunity" 表示歐盟國家，或 "thirdPartyCountry" 表示非歐盟國家）。

🔧 技術細節

項目構建

要構建此項目，請運行以下命令：

npm install

構建說明

• 項目依賴於 Node.js 環境。
• 確保安裝所有所需的依賴項。

📄 許可證

請參考項目的 LICENSE 文件以獲取許可詳細信息。