Mindmap MCP Server

Markdown içeriğini etkileşimli zihni haritalarına dönüştürmek için Model Context Protocol (MCP) sunucusu.

Kurulum

pip install mindmap-mcp-server

Veya uvx kullanarak:

uvx mindmap-mcp-server

Veya docker kullanarak daha güvenli ve kolay.

Dikkat

Üç kurulum yöntemi macOS ve Linux'ta başarıyla test edilmiştir.

Windows kullanıcıları bu MCP için npx ile sorun yaşıyorsanız, Docker yöntemini kullanmayı düşünün. Alternatif olarak, Visual Studio Code kullanıyorsanız, "Markmap" uzantısı, komut satırı araçlarında gezinmekten daha basit bir çözüm sunabilir.

Çözülmemiş sorunlar yaşıyorsanız, bu MCP sunucusunu kullanmak yerine benim son sistem istemini Mindmap Asistanı olarak kullanabilirsiniz.

Bu MCP sunucusunu kullanmak yerine sistem istemini kullanma

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/markmap-autoloader@0.18"></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>

Görselleştirme seçenekleri: (Formüller veya semboller doğru görüntülenmiyorsa, HTML dosyasını indirin ve tarayıcıda açın.)

Zihni haritayı yapay zeka ürünlerinde görüntüleyin (varsa):
HTML dosyasını zihni harita olarak render edin:

Ön Koşullar

Bu paket, python veya uvx komutunu kullanarak sunucuyu çalıştırırken Node.js'nin yüklü olmasını gerektirir.

Kullanım

Claude Desktop veya diğer MCP istemcileriyle

Bu sunucuyu claude_desktop_config.json dosyanıza ekleyin:

`uvx` kullanarak:

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

veya

önerilen:

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

zihni harita içeriğinin dönüş türünü belirtmek için --return-type kullanırız, ihtiyacınıza göre html veya filePath seçebilirsiniz.
html zihni haritanın tüm HTML içeriğini döndürecek ve bunu yapay zeka istemcinizin ürünlerinde önizleyebilirsiniz;

return_html_content

html_preview

filePath zihni haritayı bir dosyaya kaydedecek ve dosya yolunu döndürecektir, bunu tarayıcınızda açabilirsiniz. Token'lerinizi tasarruf edebilir!

generate_file

file_to_open

`python` kullanarak:

Bu depo'daki belirli bir Python dosyasını kullanma:

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

veya

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

zihni harita içeriğinin dönüş türünü belirtmek için --return-type kullanırız, ihtiyacınıza göre html veya filePath seçebilirsiniz. Daha fazla ayrıntı için uvx kullanımına bakın.

`docker` kullanarak:

Öncelikle image'i çekin:

docker pull ychen94/mindmap-converter-mcp

İkinci olarak, sunucuyu ayarlayın:

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

⚠️ /path/to/output/folder yerine sisteminizdeki zihni haritaları kaydetmek istediğiniz gerçek bir yol yazın, macOS'ta /Users/username/Downloads veya Windows'ta C:\\Users\\username\\Downloads gibi.

Docker konteynerinde sağlanan araçlar Sunucu aşağıdaki MCP araçlarını sağlar:

markdown-to-mindmap-content
Markdown'ı HTML zihni haritasına dönüştürür ve tüm HTML içeriğini döndürür.
docker komutunda şu argümanları kullanmazsınız: -v ve /path/to/output/folder:/output.
Parametreler:
• markdown (string, gerekli): Dönüştürülecek Markdown içeriği
• toolbar (boolean, isteğe bağlı): Araç çubuğunu gösterilip gösterilmeyeceği (varsayılan: true)
En iyi kullanım: HTML içeriği boyutunun sorun olmadığı basit zihni haritalar için. Ayrıca yapay zeka istemcinizde zihni haritayı önizlemek için ürünleri kullanabilirsiniz.
markdown-to-mindmap-file
Markdown'ı HTML zihni haritasına dönüştürür ve bağlanan dizine bir dosya olarak kaydeder.
Parametreler:
• markdown (string, gerekli): Dönüştürülecek Markdown içeriği
• filename (string, isteğe bağlı): Özel dosya adı (varsayılan: otomatik oluşturulan zaman damgalı ad)
• toolbar (boolean, isteğe bağlı): Araç çubuğunu gösterilip gösterilmeyeceği (varsayılan: true)
En iyi kullanım: Karmaşık zihni haritalar için veya iş akışınızı kesintiye uğratmadan daha sonra kullanmak için token'lerinizi tasarruf etmek istediğinizde.
html dosyasını tarayıcıda açarak zihni haritayı görüntüleyebilirsiniz. Ayrıca dosyayı iş akışınızı kesintiye uğratmadan tarayıcıda açmak için iterm-mcp-server veya diğer terminal MCP sunucularını kullanabilirsiniz.

Sorun Giderme

Dosya Bulunamadı
Zihni harita dosyanız erişilemez durumda ise:
1 Bir volume'ü Docker konteynerine doğru şekilde bağladığınızı kontrol edin
2 Yol biçiminin işletim sisteminiz için doğru olduğundan emin olun
3 Docker'ın dizine erişim izni olduğundan emin olun

Docker Komutu Bulunamadı
1 Docker'ın yüklenmiş olduğunu ve PATH'de olduğunu doğrulayın
2 Docker'ın mutlak yolunu kullanmayı deneyin

Sunucu Claude'da Görünmüyor
1 Yapılandırma değişikliklerinden sonra Claude Desktop'ı yeniden başlatın
2 Bağlantı hataları için Claude günlüklerini kontrol edin
3 Docker'ın çalışıyor olduğunu doğrulayın

Gelişmiş Kullanım
Diğer MCP İstemcileriyle Kullanma
Bu sunucu, yalnızca Claude Desktop değil, MCP uyumlu herhangi bir istemciyle çalışır. Sunucu Model Context Protocol (MCP) sürüm 1.0 belirtimini uygular.

Özellikler

Bu sunucu, markmap-cli kütüphanesini kullanarak Markdown içeriğini zihni haritalarına dönüştürmek için bir araç sağlar:

Markdown'ı etkileşimli zihni harita HTML'sine dönüştürün
Çevrimdışı kullanıma uygun zihni haritalar oluşturma seçeneği
Araç çubuğunu gizleme seçeneği
HTML içeriği veya dosya yolu döndürün

Örnek

Claude'da şunları sorabilirsiniz:

"aşağıdaki markdown kodu için bir zihni harita verin, zihni harita aracını kullanarak:

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

Zihni haritayı bir dosyaya kaydetmek ve ardından iTerm MCP sunucusunu kullanarak tarayıcıda açmak istiyorsanız:

"aşağıdaki markdown input_code için bir zihni harita verin zihni harita aracını kullanarak, daha sonra, oluşturulan html dosyasını açmak için iterm'i kullanın. input_code:

markdown içeriği

"Bir filin buzdolabına konulması sürecini düşün ve bir zihni harita sağla. Bunu terminalle aç."

sonucu gör

aiworkflow

mindmapinbrowser

ve daha fazlası

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır. Daha fazla ayrıntı için lütfen bu proje deposundaki LICENSE dosyasını inceleyin

Bu proje sizin için yararlı olduysa, lütfen ona bir Star ⭐️ vermeyi düşünün

Teknolojinin ilerlemesi genel nüfusu sömürmek yerine tüm bireylere fayda sağlamalıdır.

YuChenSSR/mindmap-mcp-server

Bu MCP sunucusu hakkında