マインドマップMCPサーバー

Markdown コンテンツをインタラクティブなマインドマップに変換するための Model Context Protocol (MCP) サーバー。

インストール

pip install mindmap-mcp-server

またはuvxを使用します:

uvx mindmap-mcp-server

あるいは、 dockerより安全かつ簡単に使用します。

前提条件

このパッケージでは、コマンドpythonまたはuvxを使用してサーバーを実行するときに、Node.js がインストールされている必要があります。

使用法

Claude Desktop またはその他の MCP クライアントの場合

このサーバーをclaude_desktop_config.jsonに追加します。

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "html"]
    }
  }
}

または

推奨：

{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": ["mindmap-mcp-server", "--return-type", "filePath"]
    }
  }
}

--return-typeを使用してマインドマップコンテンツの戻り値の型を指定します。必要に応じてhtmlまたはfilePathを選択できます。
htmlマインドマップの HTML コンテンツ全体を返し、AI クライアントのアーティファクトでプレビューできます。

filePathマインドマップをファイルに保存し、そのファイルパスを返します。このファイルはブラウザで開くことができます。トークンも保存できます。

このリポジトリ内の特定の Python ファイルを使用する:

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "html"]
    }
  }
}

または

{
  "mcpServers": {
    "mindmap": {
      "command": "python",
      "args": ["/path/to/your/mindmap_mcp_server/server.py", "--return-type", "filePath"]
    }
  }
}

マインドマップコンテンツの戻り値の型を指定するには--return-typeを使用します。必要に応じてhtmlまたはfilePathを選択できます。詳細については、`uvx` の使用を参照してください。

まず、イメージをプルします。

docker pull ychen94/mindmap-converter-mcp

次に、サーバーを設定します。

{
  "mcpServers": {
    "mindmap-converter": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-v", "/path/to/output/folder:/output", "ychen94/mindmap-converter-mcp:latest"]
    }
  }
}

⚠️ /path/to/output/folderマインドマップを保存するシステム上の実際のパス (macOS では/Users/username/Downloads 、Windows ではC:\\Users\\username\\Downloadsなど) に置き換えます。

Docker コンテナで提供されるツールサーバーは次の MCP ツールを提供します。

マークダウンからマインドマップコンテンツへ
Markdown を HTML マインドマップに変換し、HTML コンテンツ全体を返します。
コマンドdockerでは、引数-vと/path/to/output/folder:/output使用しません。
パラメータ:
• markdown (文字列、必須): 変換するMarkdownコンテンツ
• ツールバー（ブール値、オプション）：ツールバーを表示するかどうか（デフォルト：true）
最適な用途：HTMLコンテンツのサイズが問題にならないシンプルなマインドマップ。AIクライアントのアーティファクトを使用してマインドマップをプレビューできます。
マークダウンからマインドマップファイルへ
Markdown を HTML マインドマップに変換し、マウントされたディレクトリ内のファイルに保存します。
パラメータ:
• markdown (文字列、必須): 変換するMarkdownコンテンツ
• ファイル名（文字列、オプション）：カスタムファイル名（デフォルト：自動生成されたタイムスタンプ名）
• ツールバー（ブール値、オプション）：ツールバーを表示するかどうか（デフォルト：true）
最適な用途: 複雑なマインドマップ、または後で使用するためにトークンを保存する場合。
ブラウザでHTMLファイルを開いてマインドマップを表示できます。また、 iterm-mcp-serverや他の端末のmcpサーバーを使えば、ワークフローを中断することなくブラウザでファイルを開くことができます。

トラブルシューティング

ファイルが見つかりません
マインドマップファイルにアクセスできない場合:
1 Dockerコンテナにボリュームが正しくマウントされているか確認する
2 パスの形式がオペレーティングシステムに合っているか確認する
3 Dockerがディレクトリにアクセスする権限を持っていることを確認する

Dockerコマンドが見つかりません
1 Dockerがインストールされ、PATHに入っていることを確認する
2 Dockerへの絶対パスを使ってみる

クロードにサーバーが表示されない
1 設定変更後にClaude for Desktopを再起動します
2 Claudeのログで接続エラーを確認する
3 Dockerが実行中であることを確認する

高度な使用法
他のMCPクライアントとの使用
このサーバーは、Claude for Desktop だけでなく、MCP 対応のあらゆるクライアントで動作します。このサーバーは、Model Context Protocol (MCP) バージョン 1.0 仕様を実装しています。

注意

macOS と Linux では 3 つのインストール方法が正常にテストされています。

Windowsユーザーで、このMCPのnpxで問題が発生している場合は、Dockerメソッドの使用を検討してください。あるいは、Visual Studio Codeをご利用の場合は、「Markmap」拡張機能を使用すると、コマンドラインツールを操作するよりも簡単な解決策が得られる可能性があります。

特徴

このサーバーはmarkmap-cliライブラリを使用して Markdown コンテンツをマインドマップに変換するためのツールを提供します。

Markdown をインタラクティブなマインドマップ HTML に変換する
オフライン対応のマインドマップを作成するオプション
ツールバーを非表示にするオプション
HTMLコンテンツまたはファイルパスを返す

例

Claude では、次のように尋ねることができます。

「マインドマップツールを使用して、次のマークダウンコードのマインドマップを作成します。」

# Project Planning
## Research
### Market Analysis
### Competitor Review
## Design
### Wireframes
### Mockups
## Development
### Frontend
### Backend
## Testing
### Unit Tests
### User Testing

「

マインドマップをファイルに保存し、iTerm MCP サーバーを使用してブラウザで開く場合:

「マインドマップツールを使用して次のマークダウン input_code のマインドマップを作成し、その後、iterm を使用して生成された HTML ファイルを開きます。input_code:

markdown content

「

「象を冷蔵庫に入れるプロセスを考えて、マインドマップを作成してください。ターミナルで開いてください。 」

その他

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、このプロジェクトリポジトリのLICENSEファイルをご覧ください。

このプロジェクトが役に立った場合は、ぜひ星⭐️を付けてください。

技術の進歩は、一般大衆を搾取するのではなく、すべての個人に利益をもたらすべきだ。

Mindmap MCP Server

Integrations