Leanix MCP Integration

🚀 LeanIX MCP 統合

LeanIXをAIアシスタントに接続するモデルコンテキストプロトコル（MCP）サーバーです。LeanIXのGraphQL APIをMCPツールとして公開し、AIアシスタントが利用できるようにします。

✨ 主な機能

この統合により、LeanIX操作に使用できる5つのMCPツールが提供されます。

1. ファクトシートの概要：ワークスペース内のファクトシートの数と統計情報を取得します。
2. 検索：名前でファクトシートを検索します。
3. サブスクリプション管理：特定のファクトシートのサブスクライバーを表示します。
4. ファクトシートの作成：ワークスペースに新しいファクトシートを追加します。
5. ファクトシートの更新：既存のファクトシートの情報を変更します。

📦 インストール

前提条件

• Node.js (v14 以上)
• LeanIXワークスペースとAPIトークン
• GraphQLとMCPの基本的な理解

手順

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. ルートディレクトリに .env ファイルを作成し、LeanIXの認証情報を記述します。

   LEANIX_SUBDOMAIN=your-workspace-subdomain
   LEANIX_TOKEN=your-api-token
   

📚 ドキュメント

プロジェクト構造

├── server.js            # 主なMCPサーバーの設定と初期化
├── leanix-client.js     # LeanIX APIクライアントの実装
├── api                  # LeanIX APIの定義とエンドポイント
├── mutation            # GraphQLのミューテーション定義
├── datamodel           # データモデルと型定義
├── .env                # 環境設定
└── src/
    ├── config/
    │   └── config.js         # 環境変数からLeanIXの認証情報を読み込み、検証する
    ├── graphql/
    │   └── queries/         # GraphQLのクエリとミューテーション
    │       ├── factSheetQueries.js     # ファクトシート操作のクエリ
    │       └── workspaceQueries.js     # ワークスペースレベル操作のクエリ
    ├── tools/
    │   └── workspaceTools.js # 5つのMCPツールを定義し、登録する
    ├── types/
    │   └── schemas.js       # ツールのパラメータを検証するZodスキーマ
    └── utils/
        └── responseHandler.js # MCP互換の構造でレスポンスをフォーマットする

よくある質問と解決策

1. GraphQLスキーマの不一致：常に現在のLeanIX APIスキーマを確認してください。スキーマは時間とともに変更される可能性があります。
2. レスポンス形式：すべてのMCPツールのレスポンスは、以下の形式に従う必要があります。

   {
     content: [{
       type: "text",
       text: "your response here"
     }]
   }
   

3. エラー処理：常に withErrorHandling でツールの実装をラップし、正しいエラーレスポンスを確保してください。
4. 環境変数：API呼び出しを行う前に、環境変数が正しく読み込まれ、検証されていることを確認してください。

Claude Desktopの設定

このMCPサーバーをClaude Desktopとともに使用するには、Claudeの設定ファイルにサーバーの設定を追加します。設定ファイルは通常以下の場所にあります。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します。

{
    "mcpServers": {
      "myserver": {
        "command": "node",
        "args": [
          "/path/to/your/lean/server.js"
        ]
      }
    }
}

/path/to/your/lean/server.js を server.js ファイルの絶対パスに置き換えます。これにより、Claude Desktopは以下のことを行います。

1. 必要に応じてこのMCPサーバーを起動します。
2. このサーバーを介してLeanIX操作を行います。
3. Node.jsでサーバーを実行します。

統合のテスト

1. サーバーを起動します。

   node server.js
   

2. ブラウザを開き、 http://localhost:3000 にアクセスします。

デバッグのヒント

• すべての環境変数が正しく設定されていることを確認してください。
• コンソール出力を確認し、エラーや警告メッセージを確認してください。
• ブラウザの開発者ツールを使用して、ネットワークリクエストとレスポンスを確認してください。

リソース

• LeanIX ドキュメント
• GraphQL 公式サイト
• MCP プロトコルドキュメント