Xmind Mind Maps

🚀 MCP XMind サーバ

XMindマインドマップを分析およびクエリするためのModel Context Protocolサーバです。このツールは、XMindファイルの内容を強力に検索、抽出、分析する機能を提供します。

✨ 主な機能

• 🔍 スマートな曖昧検索
• 📝 タスク管理と追跡
• 🌲 階層型コンテンツナビゲーション
• 🔗 リンクと参照の抽出
• 📊 複数ファイルの分析
• 🏷️ タグサポート
• 📂 ディレクトリスキャン
• 🔒 セキュアなディレクトリアクセス

📦 インストール

Smitheryを通じたインストール

Smithery を通じてClaudeデスクトップ版のXMindサーバを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @41px/mcp-xmind --client claude

手動インストール

npm install @modelcontextprotocol/sdk adm-zip zod
npm install --save-dev typescript @types/node

💻 使用例

サーバの起動

node dist/index.js <許可されたディレクトリ> [その他のディレクトリ...]

利用可能なツール

1. read_xmind
   • XMindファイルを解析して分析します。
   • 完全なマインドマップ構造を抽出します。
2. get_todo_tasks
   • TODOタスクを抽出して分析します。
   • タスクのコンテキストと階層構造を含みます。
3. list_xmind_directory
   • XMindファイルを再帰的にスキャンします。
   • 結果をフィルタリングして整理します。
4. read_multiple_xmind_files
   • 複数のファイルを同時に処理します。
   • ファイル間の内容を比較して分析します。
5. search_xmind_files
   • 名前パターンに基づいてファイルを検索します。
   • ディレクトリを再帰的にスキャンします。
6. extract_node
   • スマートな曖昧パスマッチングを行います。
   • 検索結果をランク付けします。
   • 完全なサブツリーを抽出します。
7. extract_node_by_id
   • IDを介して直接ノードにアクセスします。
   • 高速かつ正確な検索を行います。
8. search_nodes
   • 複数の基準によるコンテンツ検索を行います。
   • 検索フィールドを設定可能です。

基本的な使用法

ノードの検索

{
    "name": "search_nodes",
    "arguments": {
        "path": "/path/to/file.xmind",
        "query": "project",
        "searchIn": ["title", "notes"],
        "caseSensitive": false
    }
}

ノードの抽出

{
    "name": "extract_node",
    "arguments": {
        "path": "/path/to/file.xmind",
        "searchQuery": "Feature > API"
    }
}

タスクの一覧表示

{
    "name": "get_todo_tasks",
    "arguments": {
        "path": "/path/to/file.xmind"
    }
}

📚 ドキュメント

開発用設定

開発用の claude_desktop_config.json の例：

{
  "xmind": {
    "command": "node dist/index.js",
    "args": ["--development"]
  }
}

本番用設定

本番用の claude_desktop_config.json の例：

{
  "xmind": {
    "command": "node dist/index.js"
  }
}

🔧 技術詳細

セキュリティ

• セキュアなディレクトリアクセス：指定されたディレクトリへのアクセスを制限することで、ファイル操作の安全性を確保します。

開発情報

依存関係のインストール

npmまたはyarnを使用してプロジェクトの依存関係をインストールします。

npm install
# または
yarn install

テストの実行

プロジェクトのテストを実行します。

npm test
# または
yarn test

ビルド

本番用のビルドを生成します。

npm run build
# または
yarn build