MindManager MCP Server

警告

非推奨： この MCP の開発は今後行われません。代わりに、https://github.com/robertZaufall/mindm-skill の Codex／Claude スキルをご利用ください。

MindManager MCP サーバー

mindm ライブラリ向けの Model Context Protocol（MCP）サーバー実装です。Windows および macOS 上の MindManager とやり取りするための標準化されたインターフェースを提供します。

概要

このサーバーを使用すると、LLM にコンテキストとツールを提供するための標準化された方法である Model Context Protocol（MCP）を通じて、MindManager とプログラムからやり取りできます。mindm ライブラリを活用して、MindManager ドキュメント、トピック、関係、その他のマインドマップ要素を操作します。

アニメーションの例（Windows 上の VSCode で Codex を使用）

• 例 タグや新しいトピック用のアイコンを含め、単一のトピックを洗練する例：

現在の Mindmanager マインドマップを Mermaid（完全版）として取得し、指定したトピックを少なくとも 2 階層の深さまで（トピックだけでなく）洗練し、最も重要な上位 3 つのトピックに「Important」タグを追加し、中央のトピック以外のすべてのトピックに対応する標準アイコンを追加して、新しい MindManager マインドマップを作成してください

• 例 新しいトピックのノートにテキストを生成して、単一のトピックを洗練する例：

• 例 サポートされているすべてのトピックプロパティを含めてマップを複製する例：

その他の例

クライアント

現在の MindManager マインドマップを取得し、すべてのトピックをドイツ語に翻訳して、新しい MindManager マインドマップを作成してください（簡易）。

現在の MindManager マインドマップを取得し、各トピックを 2 階層分洗練して、新しい MindManager マインドマップを作成してください（簡易）。

シェル：

codex exec "現在の MindManager マインドマップを取得し、すべてのトピックに意味のある絵文字を追加して、新しい MindManager マインドマップを作成してください（簡易）"

注：絵文字は macOS でのみ機能します。

機能

• マインドマップの構造と中心トピックを取得
• LLM とのチャットで使用できるよう、マインドマップを Mermaid、Markdown、JSON 形式でエクスポート
• Mermaid（完全構文または簡易構文）から MindManager マインドマップを直接作成
• MindManager とパッケージのバージョンを取得して、すばやく診断
• MindManager のインストール先とライブラリフォルダーに関する情報を取得
• MindManager で現在選択されている項目を取得

今後の予定

• Mermaid を介さずにトピックやサブトピックを追加、変更、操作
• トピック間の関係を追加
• トピックにタグを追加
• ドキュメントの背景画像を設定

要件

• Python 3.12 以上
• mcp パッケージ（Model Context Protocol SDK）
• mindm ライブラリ（このプロジェクトに含まれています）
• Windows または macOS にインストールされた MindManager（対応バージョン：23 以降）

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

Windows へのインストール

# 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 Inspector

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

Claude Desktop

ローカルの Python ファイル

必要に応じて、ローカルファイルへのパスを調整してください。

{
  "mcpServers": {
    "mindm (MindManager)": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mindm>=0.0.5.3",
        "--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.5.3",
          "--with",
          "mindm-mcp>=0.0.2.1",
          "--with",
          "fastmcp",
          "--with",
          "markdown-it-py",
          "-m",
          "mindm_mcp.server"
        ],
        "env": {
            "VIRTUAL_ENV": "/Users/master/git/mindm-mcp/.venv"
        }
      }
  }
}

ヒント：Windows で MCP サーバーがハンマーアイコン付きで表示されない場合は、Claude Desktop を終了し、すべてのバックグラウンドプロセスを終了してください。

Codex（VSCode 拡張機能／CLI）

ローカルの Python ファイル

config.toml（必要に応じて、ローカルファイルへのパスを調整してください）。

[features]
rmcp_client = true

[mcp_servers.mindmanager]
command = "uv"
args = ["run", "--with", "mindm>=0.0.5.3", "--with", "fastmcp", "--with", "markdown-it-py", "/Users/master/git/mindm-mcp/mindm_mcp/server.py"]

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

config.toml

[features]
rmcp_client = true

[mcp_servers.mindmanager]
command = "uv"
args = ["run", "--with", "mindm>=0.0.5.3", "--with", "fastmcp", "--with", "markdown-it-py", "--with", "mindm-mcp>=0.0.2.1", "-m", "mindm_mcp.server"]

VSCode Chat（GitHub Copilot）

ローカルの Python ファイル：

必要に応じて、ローカルファイルへのパスを調整してください。

uv run --with mindm>=0.0.5.3 --with fastmcp --with markdown-it-py /Users/master/git/mindm-mcp/mindm_mcp/server.py

または、mcp.json のサーバー定義：

		"Mindmanager": {
			"type": "stdio",
			"command": "uv",
			"args": [
				"run",
				"--with",
				"mindm>=0.0.5.3",
				"--with",
				"fastmcp",
				"--with",
				"markdown-it-py",
				"/Users/master/git/mindm-mcp/mindm_mcp/server.py"
			]
		}

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

uv run --with mindm>=0.0.5.3 --with fastmcp --with markdown-it-py --with mindm-mcp>=0.0.2.1 -m mindm_mcp.server

または、mcp.json のサーバー定義：

		"Mindmanager": {
			"type": "stdio",
			"command": "uv",
			"args": [
				"run",
				"--with",
				"mindm>=0.0.5.3",
				"--with",
				"fastmcp",
				"--with",
				"markdown-it-py",
				"--with",
				"mindm-mcp>=0.0.2.1",
				"-m",
				"mindm_mcp.server"
			]
		}

MCP ツール

このサーバーは、Model Context Protocol を通じて次のツールを公開します：

ドキュメントの操作

• get_mindmap：MindManagerから現在のマインドマップ構造を取得します
• get_selection：MindManagerで現在選択されているトピックを取得します
• get_library_folder：MindManagerライブラリフォルダーのパスを取得します
• get_mindmanager_version：インストールされているMindManagerのバージョンを取得します
• get_grounding_information：マインドマップから根拠情報（中心トピック、選択されているサブトピック）を抽出します

シリアル化

• serialize_current_mindmap_to_mermaid：現在読み込まれているマインドマップをMermaid形式にシリアル化します
• serialize_current_mindmap_to_markdown：現在読み込まれているマインドマップをMarkdown形式にシリアル化します
• serialize_current_mindmap_to_json：現在読み込まれているマインドマップを、IDマッピングを含む詳細なJSONオブジェクトにシリアル化します

作成

• create_mindmap_from_mermaid：MermaidからMindManagerのマップを作成します（IDとメタデータを含む完全な構文）
• create_mindmap_from_mermaid_simple：簡略化されたMermaidテキストからMindManagerのマップを作成します

バージョン管理

• get_versions：デバッグ用にmindm-mcpおよびmindmパッケージのバージョンを返します

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

• Windows：トピック、ノート、アイコン、画像、タグ、リンク、関係、およびRTF形式を完全にサポートします
• macOS：トピック、ノート、関係をサポートします（Windowsと比べてサポートは限定的です）

Claudeおよびその他のLLMとの連携

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

1. マインドマップのコンテンツにアクセスする
2. マインドマップを操作する（近日対応予定）
3. LLMが生成したコンテンツに基づいて新しいマインドマップを作成する（近日対応予定）

トラブルシューティング

• サーバーを起動する前に、MindManagerが実行されていることを確認してください
• macOSでは、Claude DesktopによるMindManagerの自動操作を許可してください

MCPHub

MCPHubで認定済み

謝辞

このプロジェクトは、WindowsおよびmacOSプラットフォーム上のMindManager向けPythonインターフェースを提供するmindmライブラリを基盤としています。また、Anthropicが開発したModel Context Protocol（MCP）SDKを使用しています。

ライセンス

MIT License - 詳細についてはLICENSEファイルを参照してください