Mindm MCP

🚀 MindManager MCP サーバー

mindm ライブラリを使用した Model Context Protocol (MCP) サーバーの実装で、Windows と macOS 上の MindManager との相互作用をサポートします。

🚀 クイックスタート

このサーバーは、Model Context Protocol（MCP）に基づいて構築され、mindm ライブラリを使用して Windows と macOS プラットフォーム上で MindManager との相互作用を可能にするインターフェースを提供します。

✨ 主な機能

実装済みの機能

• 現在のマインドマップの構造を検索
• MindManager 内の現在選択されているテーマを取得
• MindManager ライブラリのフォルダパスを取得
• マインドマップ内の位置情報（中心テーマと選択されたサブテーマ）を抽出

実装予定の機能

• 新しいマインドマップを作成
• テーマと関連項目の追加、削除、および修正

📦 インストール

インストール要件

• Python バージョン：Python 3.10 以上が必要です。
• 依存ライブラリ：mcp と mindm ライブラリが必要です。
• MindManager サポート：MindManager の Windows と macOS バージョンをサポートします。

macOS システム

# リポジトリをローカルディレクトリにクローン
$ mkdir -p mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .

# 仮想環境を作成し、依存関係をインストール
$ python3 -m venv ./.venv

# 仮想環境をアクティブ化（macOS/Linux）
$ source ./.venv/bin/activate

# プロジェクトの依存関係をインストール
$ pip install --editable .

Windows システム

# リポジトリをローカルディレクトリにクローン
$ mkdir mindmanager-mcp-server && cd $_
$ git clone https://github.com/your-repository.git .

# 仮想環境を作成し、依存関係をインストール
$ python -m venv ./.venv

# 仮想環境をアクティブ化（Windows）
$ .\.\venv\Scripts\activate.bat

# プロジェクトの依存関係をインストール
$ pip install --editable .

💻 使用例

MCP チェックツールを実行

# MCP サーバーを起動
$ mindm-mcp-server start

Claude Desktop での MCP サービスの設定

方法一：ローカルファイルを使用した設定

Claude Settings の MCP 設定ファイル に以下の内容を追加します。

{
  "servers": [
    {
      "name": "mindmanager",
      "host": "localhost",
      "port": 12345,
      "executable_path": "/path/to/MindManager"
    }
  ]
}

方法二：パッケージリポジトリからモジュールをインストール

Claude Settings の MCP 設定ファイル に以下の内容を追加します。

{
  "servers": [
    {
      "name": "mindmanager",
      "host": "localhost",
      "port": 12345,
      "module_path": "mindmanager-mcp-server"
    }
  ]
}

📚 ドキュメント

MCP ツール

ドキュメント操作ツール

• 現在のマインドマップの構造を取得
• 現在選択されているテーマを取得
• MindManager ライブラリのフォルダパスを取得
• マインドマップ内の位置情報を抽出

シリアライズツール

• 現在のマインドマップを Mermaid 形式にシリアライズ
• 現在のマインドマップを Markdown 形式にシリアライズ
• 現在のマインドマップを JSON 形式にシリアライズ

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

• Windows：テーマ、メモ、アイコン、画像、ラベル、リンク、関係、および RTF 形式を完全にサポートします。
• macOS：テーマ、メモ、および関係のみをサポートします（機能制限あり）。

Claude および他の LLM との統合

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

1. マインドマップの内容にアクセスする
2. マインドマップを操作する（近日公開）
3. LLM で生成された内容に基づいて新しいマインドマップを作成する（近日公開）

トラブルシューティング

• サーバーを実行する前に、MindManager が起動していることを確認してください。
• macOS の場合、Claude Desktop が MindManager を自動化する権限を持っていることを確認してください。

🔧 技術詳細

このプロジェクトは mindm ライブラリに基づいて構築され、Windows と macOS で MindManager にアクセスする Python インターフェースを提供します。また、Anthropic が開発した Model Context Protocol（MCP）SDK を使用しています。

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。