MindManager MCP サーバー

mindmライブラリ用のモデルコンテキストプロトコル (MCP) サーバー実装。Windows および macOS 上の MindManager と対話するための標準化されたインターフェイスを提供します。

概要

このサーバーは、LLMにコンテキストとツールを提供するための標準化された方法であるモデルコンテキストプロトコル（MCP）を介して、MindManagerとプログラム的にやり取りすることを可能にします。このサーバーは、 mindmライブラリを活用して、MindManagerのドキュメント、トピック、リレーションシップ、その他のマインドマップ要素を操作します。

例：

特徴

マインドマップの構造と中心トピックを取得する
マインドマップをMermaid、Markdown、JSON形式にエクスポートしてLLMチャットで使用できるようにします。
MindManager のインストールとライブラリフォルダに関する情報を取得します
MindManagerから現在の選択を取得する

計画されている機能

シリアル化されたデータから新しいマインドマップを作成する
トピックとサブトピックを追加、変更、操作する
トピック間の関係を追加する
トピックにタグを追加する
ドキュメントの背景画像を設定する

要件

Python 3.12以上
mcpパッケージ (モデルコンテキストプロトコル SDK)
mindmライブラリ（このプロジェクトに含まれています）
MindManager（サポート対象バージョン：23以降）がWindowsまたはmacOSにインストールされている

macOSへのインストール

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
brew install uv # if needed
uv pip install -r pyproject.toml

# alternative: manual installation of modules
uv add "mcp[cli]"
uv add fastmcp
uv add markdown-it-py
uv add -U --index-url=https://test.pypi.org/simple/ --extra-index-url=https://pypi.org/simple/ mindm mindm-mcp

インストールウィンドウ

# Change to DOS command prompt
cmd

# Clone the repository (if you're using it from a repository)
git clone https://github.com/robertZaufall/mindm-mcp.git
cd mindm-mcp

# create a virtual environment for Python
pip install uv # if needed
uv pip install -r pyproject.toml

# install nodejs
choco install nodejs # if you have chocolatey installed. If not install nodejs otherwise
refreshenv
node -v
npm install -g npx

使用法

MCP検査官

# run mcp with inspector
uv run --with mind --with fastmcp --with markdown-it-py mcp dev mindm_mcp/server.py

クロードデスクトップ

ローカルPythonファイル

必要に応じてローカルファイルのパスを調整します。

{
  "mcpServers": {
    "mindm (MindManager)": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mindm>=0.0.4.6",
        "--with",
        "fastmcp",
        "--with",
        "markdown-it-py",
        "/Users/master/git/mindm-mcp/mindm_mcp/server.py"
      ]
    }
  }
}

パッケージリポジトリからのモジュール

必要に応じてVIRTUAL_ENVを調整します。

{
    "mcpServers": {
      "mindm (MindManager)": {
        "command": "uv",
        "args": [
          "run",
          "--with",
          "mindm>=0.0.4.6",
          "--with",
          "mindm-mcp>=0.0.1.50",
          "--with",
          "fastmcp",
          "--with",
          "markdown-it-py",
          "-m",
          "mindm_mcp.server"
        ],
        "env": {
            "VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
        }
      }
    }
}

ヒント: Windows 上で MCP サーバーがハンマーアイコンとともに表示されない場合は、Claude Desktop を閉じて、すべてのバックグラウンドプロセスを終了します。

MCPツール

サーバーは、モデルコンテキストプロトコルを通じて次のツールを公開します。

ドキュメントインタラクション

get_mindmap : MindManager から現在のマインドマップ構造を取得します。
get_selection : MindManager で現在選択されているトピックを取得します。
get_library_folder : MindManager ライブラリフォルダへのパスを取得します。
get_grounding_information : マインドマップからグラウンディング情報（中心トピック、選択されたサブトピック）を抽出します。

シリアル化

serialize_current_mindmap_to_mermaid : 現在ロードされているマインドマップをMermaid形式にシリアル化します
serialize_current_mindmap_to_markdown : 現在読み込まれているマインドマップをMarkdown形式にシリアル化します
serialize_current_mindmap_to_json : 現在読み込まれているマインドマップを、IDマッピング付きの詳細なJSONオブジェクトにシリアル化します。

プラットフォームサポート

Windows : トピック、メモ、アイコン、画像、タグ、リンク、関係、RTF フォーマットの完全サポート
macOS : トピック、メモ、関係のサポート (Windows に比べてサポートが制限されています)

クロードや他のLLMとの統合

この MCP サーバーは、Claude Desktop またはその他の MCP 互換アプリケーションにインストールすることができ、LLM は次のことが可能になります。

マインドマップのコンテンツにアクセスする
マインドマップを操作する（近日公開）
LLM で生成されたコンテンツに基づいて新しいマインドマップを作成する (近日公開予定)

トラブルシューティング

サーバーを起動する前に MindManager が実行中であることを確認してください
macOSの場合は、Claude DesktopがMindManagerを自動化できるようにしてください。

謝辞

このプロジェクトはmindmライブラリをベースに構築されており、WindowsおよびmacOSプラットフォーム上のMindManagerへのPythonインターフェースを提供します。Anthropicが開発したModel Context Protocol (MCP) SDKを使用しています。

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照

MindManager MCP Server

Integrations