Mindmap MCP Server

🚀 Mindmap MCP サーバー

このサーバーは、Model Context Protocol (MCP) プロトコルの下で、markmap-cli ライブラリを使用して Markdown をインタラクティブなマインドマップ HTML に変換するツールです。このサーバーは MCP プロトコルバージョン 1.0 仕様を実装しています。

🚀 クイックスタート

このサーバーを使うことで、Markdown をインタラクティブなマインドマップ HTML に変換できます。以下に、インストール方法や使用方法を説明します。

✨ 主な機能

• Markdown をインタラクティブなマインドマップ HTML に変換する
• オフラインで使用可能なマインドマップの生成をサポートする
• ツールバーを隠す機能を選択できる
• HTML 内容またはファイルパスの 2 つのモードで返す

📦 インストール

方法一：ローカルインストール

# npm パッケージマネージャーを使用してグローバルにインストールする
npm install -g markmap-cli

# この MCP サーバープロジェクトをインストールする
git clone https://github.com/YuChenSSR/mindmap-mcp-server.git
cd mindmap-mcp-server
npm install

方法二：Docker インストール

docker pull yuchen/mindmap-mcp-server:latest

# コンテナを起動し、ポートを 3000 にマッピングする
docker run -p 3000:3000 yuchen/mindmap-mcp-server:latest

方法三：Windows ユーザー向け推奨

Windows で markmap-cli を使用する際に問題が発生した場合は、以下の方法を検討してください：

1. Docker を使用してインストールする（推奨）
2. Visual Studio Code をインストールし、Markmap プラグインを使用する

💻 使用例

基本的な使用法

Claude デスクトップ版に設定する

1. ~/.config/claude/settings.json ファイルを開く
2. 以下の設定を追加する：

   "mcpServers": [
     {
       "name": "mindmap-server",
       "url": "http://localhost:3000"
     }
   ]
   

3. Claude デスクトップアプリケーションを再起動する

その他の MCP クライアントでの使用

このサーバーは、すべての MCP プロトコルに準拠したクライアントと互換性があり、標準 API を通じたインタラクションをサポートしています。

高度な使用法

Claude での対話例

1. マインドマップの生成を要求する：

   給我一个用于展示以下 Markdown 代码的思维导图，使用思维导图工具：
   # 项目计划
   ## 研究
   ### 市场分析
   ### 竞争对手审查
   ## 设计
   ### 线框图
   ### 模板
   

2. ファイルの保存と開くを要求する：

   使用思维导图工具将以下 Markdown 内容转换为思维导图，然后用终端打开生成的 HTML 文件。
   输入内容：
   <粘贴你的 Markdown 代码>
   

3. 動的な思考過程：

   想象一下如何将一头大象放进冰箱，并提供一个思维导图。在终端中打开它。
   

🔧 技術詳細

トラブルシューティングガイド

1. ファイルが見つからない

• 症状：サーバーが 404 エラーを返し、ファイルが存在しないと表示される。
• 解決方法：
  • ターゲットパスが正しいか確認する。
  • 生成されたファイル名が要求と一致することを確認する。

2. Docker コマンドが認識されない

• 症状：docker コマンドを入力すると、システムがコマンドが見つからないと表示する。
• 解決方法：
  • Docker 環境をインストールして構成する。
  • Docker をシステムの PATH 変数に追加する。

3. ポート競合の問題

• 症状：サーバーを起動する際にエラーが発生し、ポートが使用中であることが示される。
• 解決方法：
  • そのポートを使用しているプロセスを停止する。
  • または、サーバーの設定を変更して、別のポート番号（例：3001）を使用する。

高度な使用法

バッチ処理

複数の Markdown ファイルを一括でマインドマップに変換し、API で管理することができます。

カスタムスタイル

CSS を使用して生成される HTML ページのスタイルをカスタマイズすることができます。詳細な方法は markmap-cli のドキュメントを参照してください。

📄 ライセンス

このプロジェクトは MIT オープンソースライセンスに準拠しています。詳細は LICENSE ファイルを参照してください。

💡 使用アドバイス

• 3 つのインストール方法は、macOS および Linux システムで正常にテストされています。
• Windows ユーザーが npx の問題に遭遇した場合は、Docker または Visual Studio Code の Markmap プラグインの使用をお勧めします。

🤝 貢献ガイド

Pull Request や Issues の提出を歓迎します！一緒にこのプロジェクトを改善しましょう！