mcpField
M
Mindmap MCP Server

Mindmap MCP Server

ローカル
github.com/YuChenSSR生産性24075 週間前に更新
リポジトリ

Mindmap MCP Server について

Mindmap MCP Server は、Markdown の内容をインタラクティブなマインドマップに変換する MCP サーバーです。pip、uvx、Docker による導入に対応し、文書の構造を視覚化したい利用者に向いています。

主な機能

  1. 01Markdown からインタラクティブなマインドマップ HTML を生成
  2. 02HTML 内容またはファイルパスを返却
  3. 03ツールバー表示の有無を選択
  4. 04オフラインで利用可能なマインドマップの作成オプション

活用シーン

  1. 01プロジェクト計画の見出しをマインドマップに変換
  2. 02AI クライアントのアーティファクトでマインドマップを確認
  3. 03トークン消費を抑えるためファイルとして保存

MCP 対応

MCP クライアントに対して markdown-to-mindmap-content や markdown-to-mindmap-file などのツールを提供し、Markdown からマインドマップへの変換を行います。ツール名は README の Docker 版の説明に基づきます。

#mindmap#artifact#mcp-server

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "mindmap": {
      "command": "uvx",
      "args": [
        "mindmap-mcp-server"
      ]
    }
  }
}
起動コマンドuvx mindmap-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimindmap-mcp-server

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Mindmap MCP サーバー

マインドマップMCP

Markdown コンテンツをインタラクティブなマインドマップに変換する Model Context Protocol（MCP）サーバーです。

インストール

pip install mindmap-mcp-server

または、uvx を使用します。

uvx mindmap-mcp-server

あるいは、より安全で簡単な docker を使用します。

注意事項

3 つのインストール方法は、macOS と Linux で正常に動作することを確認済みです。

npx を使用してこの MCP を実行する際に問題が発生する Windows ユーザーは、Docker を使用する方法をご検討ください。また、Visual Studio Code をお使いの場合は、コマンドラインツールを使うよりも簡単な方法として、"Markmap" 拡張機能を利用できます。

問題が解決しない場合は、この MCP サーバーの代わりに、最近のシステムプロンプトをマインドマップアシスタントとして使用できます。

この MCP サーバーの代わりにシステムプロンプトを使用する 
You are a specialized assistant that generates HTML code for interactive markdown-based mind maps (markmaps). When a user sends you content, respond with a complete HTML document that displays their content as a markmap visualization.
If artifact tool is turned on, you can use the artifact.

Follow these requirements:
1. Use the markmap-autoloader library (version 0.18 or latest stable version)
2. Format the HTML exactly according to the template below
3. Replace the demo content in the template with the user's content, preserving their hierarchical structure
4. Maintain the markmap configuration options (maxWidth: 300, colorFreezeLevel: 2)
5. If the user doesn't provide markdown formatting (# for headings), format their content appropriately with main topics using # and subtopics using ##

Template to follow:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Markmap</title>
    <style>
      svg.markmap {
        width: 100%;
        height: 100vh;
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]"></script>
  </head>
  <body>
    <div class="markmap">
      <script type="text/template">
        ---
        markmap:
          maxWidth: 300
          colorFreezeLevel: 2
        ---

        # markmap

        ## Links

        - <https://markmap.js.org/>
        - [GitHub](https://github.com/markmap/markmap)

        ## Related

        - [coc-markmap](https://github.com/markmap/coc-markmap)
        - [gatsby-remark-markmap](https://github.com/markmap/gatsby-remark-markmap)

        ## Features

        - links
        - **inline** ~~text~~ *styles*
        - multiline
          text
        - `inline code`
        - Katex - $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
        - This is a very very very very very very very very very very very very very very very long line.
      </script>
    </div>
  </body>
</html>

表示オプション：（数式や記号が正しく表示されない場合は、HTML ファイルをダウンロードしてブラウザーで開いてください。）

  1. アーティファクトでマインドマップを表示する（利用可能な場合）： system_prompt_artifact

  2. HTML ファイルをマインドマップとしてレンダリングする： system_prompt_render

前提条件

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

使用方法

Claude Desktop またはその他の MCP クライアントでの使用

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

`uvx` を使用する場合： 
{
  "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 クライアントのアーティファクトでプレビューできます。

return_html_content

html_preview

filePath を指定すると、マインドマップがファイルに保存され、ファイルパスが返されます。ブラウザーで開くことができます。トークンを節約できます！

generate_file

file_to_open

`python` を使用する場合：

このリポジトリ内の特定の 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` を使用する場合：

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

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 ツールを提供します。

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

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

Docker コマンドが見つからない
1 Docker がインストールされ、PATH に設定されていることを確認します
2 Docker の絶対パスを使用してみます

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

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

特徴

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

  • Markdown をインタラクティブなマインドマップ HTML に変換します
  • オフラインで利用できるマインドマップを作成するオプションがあります
  • ツールバーを非表示にするオプションがあります
  • HTML コンテンツまたはファイルパスを返します

例

Claude では、次のように依頼できます。

「次の Markdown コードを、マインドマップツールを使ってマインドマップにしてください。

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

」

マインドマップをファイルに保存し、iTerm MCP サーバーを使ってブラウザーで開く場合は、次のように依頼できます。

「次の Markdown 入力コードを、マインドマップツールを使ってマインドマップにしてください。 その後、iTerm を使って生成された HTML ファイルを開いてください。 入力コード：

markdown content

」

「冷蔵庫にゾウを入れる手順について考え、マインドマップを作成してください。ターミナルで開いてください。」

結果を見る

AI ワークフロー

ブラウザーで表示したマインドマップ

ほかにもあります

ライセンス

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

このプロジェクトがお役に立ちましたら、ぜひ Star ⭐️ を付けてください。

テクノロジーの進歩は、一般の人々を搾取するのではなく、すべての人々に利益をもたらすべきです。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。