MCP Lexware Office

🚀 Lexware Office MCP サーバー

Lexware Office（旧称Lexoffice）を統合したMCPサーバーの実装です。モデルコンテキストプロトコルを通じて、企業の業務操作を管理するためのシームレスなインターフェースを提供します。

✨ 主な機能

• Lexware Office 統合：Lexware Office APIと直接統合します。
• 企業管理：請求書、取引先、その他の業務文書を管理します（現在は読み取り専用）。

📚 ドキュメント

以下のツールは、このMCPサーバーを通じて利用できます。

get-invoices

• Lexware Office内の請求書リストを取得します。
• 入力パラメータ：
  • status (文字列配列、オプション)：ステータスでフィルタリングします（"open", "draft", "paid", "paidoff", "voided"）。デフォルト：すべてのステータス
  • page (数値、オプション)：取得するページ番号（0から始まります）。デフォルト：0
  • size (数値、オプション)：1ページに表示する請求書の数（1 - 250）。デフォルト：250

get-invoice-details

• Lexware Office内の特定の請求書の詳細情報を取得します。
• 入力パラメータ：
  • id (文字列)：請求書のUUID

get-contacts

• 条件に基づいてLexware Office内の取引先を取得します。論理積の複数のフィルターをサポートします。
• 入力パラメータ：
  • email (文字列、オプション)：メールアドレスでフィルタリングします（ワイルドカードをサポート）
  • name (文字列、オプション)：名前でフィルタリングします（ワイルドカードをサポート）
  • number (数値、オプション)：取引先番号でフィルタリングします
  • customer (ブール値、オプション)：顧客ロールでフィルタリングします
  • vendor (ブール値、オプション)：仕入先ロールでフィルタリングします
  • page (数値、オプション)：取得するページ番号（0から始まります）。デフォルト：0
  • size (数値、オプション)：1ページに表示する取引先の数（1 - 250）。デフォルト：250

list-posting-categories

• 会計伝票で使用される仕訳区分のリストを取得します。
• 入力パラメータ：
  • type (文字列、オプション)：区分タイプでフィルタリングします（"income" または "outgo"）

list-countries

• Lexware Officeで認識されている国とその税区分情報を取得します。
• 入力パラメータ：
  • taxClassification (文字列、オプション)：税区分でフィルタリングします（"de" はドイツ、"intraCommunity" は欧州連合加盟国、"thirdPartyCountry" は非欧州連合加盟国）

📦 インストール

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"
            }
        }
    }
}

🔧 技術詳細

このプロジェクトをビルドするには、以下のコマンドを実行してください。

npm install

ビルドに関する注意事項

• このプロジェクトはNode.js環境に依存しています。
• すべての必要な依存関係がインストールされていることを確認してください。

📄 ライセンス

ライセンスの詳細については、プロジェクトのLICENSEファイルを参照してください。