Xmind Generator MCP Server

Xmind Generator MCP Server

Xmind マインドマップを生成するための MCP（Model Context Protocol）サーバーです。このサーバーを使うと、LLM は MCP プロトコルを通じて、構造化されたマインドマップを作成できます。

機能

• 階層的なトピック構造を持つ Xmind マインドマップを生成
• トピックのノート、ラベル、マーカー、関係性に対応
• マインドマップをローカルファイルに保存
• 既存の .xmind ファイルを読み込み、アウトラインを Markdown としてエクスポート
• Claude Desktop などの MCP クライアントと簡単に連携

前提条件

• Node.js：バージョン 18 以降が必要です
• Xmind：生成されたマインドマップを開いて編集するには、デスクトップアプリケーションの Xmind をインストールしてください
• Claude Desktop：このツールを拡張機能として使用するには必要です

Claude Desktop のセットアップ

オプション 1：npx を使用（推奨）

1. Claude Desktop の設定ファイルを作成または編集します。

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

2. 次の設定を追加します。

   {
     "mcpServers": {
       "xmind-generator": {
         "command": "npx",
         "args": ["xmind-generator-mcp"],
         "env": {
           "outputPath": "/path/to/save/xmind/files",
           "autoOpenFile": "false"
         }
       }
     }
   }
   

3. Claude Desktop を再起動します

4. 会話で Xmind generator を使い始めます

オプション 2：ローカルインストール

1. リポジトリをクローンします。

   git clone https://github.com/BangyiZhang/xmind-generator-mcp.git
   cd xmind-generator-mcp
   npm install
   npm run build
   

2. Claude Desktop の設定ファイルを作成または編集します。

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

3. 次の設定を追加します。

   {
     "mcpServers": {
       "xmind-generator": {
         "command": "node",
         "args": ["path/to/xmind-generator-mcp/dist/index.js"],
         "env": {
           "outputPath": "/path/to/save/xmind/files",
           "autoOpenFile": "false"
         }
       }
     }
   }
   

4. path/to/xmind-generator-mcp を、クローンしたプロジェクトの実際のパスに置き換えます

5. Claude Desktop を再起動します

6. 会話で Xmind generator を使い始めます

注：env セクションは省略可能です。サーバーの環境変数を設定できます。

• outputPath：Xmind ファイルの保存先となる既定のディレクトリまたはファイルパスです。ツール呼び出しの outputPath パラメーターで上書きできます。
• autoOpenFile：生成した Xmind ファイルを作成後に自動的に開くかどうかを制御します。自動で開かないようにするには "false" を設定します（既定値は "true" です）。

利用可能なツール

generate-mind-map

トピックの階層構造から Xmind マインドマップを生成します。

パラメーター：

• title（string）：マインドマップのタイトル（ルートトピック）
• topics（array）：マインドマップに含めるトピックの配列
  • title（string）：トピックのタイトル
  • ref（string、任意）：トピックの参照 ID
  • note（string、任意）：トピックのノート
  • labels（文字列の array、任意）：トピックのラベル
  • markers（文字列の array、任意）：トピックのマーカー（形式：「Category.name」、例：「Arrow.refresh」）
  • children（array、任意）：子トピックの配列
• relationships（array、任意）：トピック間の関係性の配列
• outputPath（string、任意）：Xmind ファイルのカスタム出力先パス。設定されている場合、環境変数を上書きします。

read-mind-map

既存の .xmind ファイルを読み込み、Markdown のアウトラインとしてエクスポートします。

パラメーター：

• inputPath（string）：.xmind ファイルのパス
• style（string、任意）：Markdown のスタイル。現在は A（アウトライン）に対応しています（B は今後、より豊富な形式でエクスポートするために予約されています）。

例：

{
  "inputPath": "/path/to/file.xmind",
  "style": "A"
}

使用例

generate-mind-map ツールの使用例を示します。

{
  "title": "Project Plan",
  "topics": [
    {
      "title": "Research",
      "ref": "topic:research",
      "note": "Gather information about the market",
      "children": [
        {
          "title": "Market Analysis",
          "labels": ["Priority: High"]
        },
        {
          "title": "Competitor Research",
          "markers": ["Task.quarter"]
        }
      ]
    },
    {
      "title": "Development",
      "children": [
        {
          "title": "Frontend",
          "markers": ["Arrow.refresh"]
        },
        {
          "title": "Backend"
        }
      ]
    }
  ]
}

ライセンス

MIT