https://github.com/jinzcdev/markmap-mcp-server
An MCP server for converting Markdown to interactive mind maps with export support (PNG/JPG/SVG).
https://github.com/jinzcdev/markmap-mcp-server
ai llm markmap mcp mcp-server mindmap mindnode xmind
Last synced: 25 days ago
JSON representation
An MCP server for converting Markdown to interactive mind maps with export support (PNG/JPG/SVG).
- Host: GitHub
- URL: https://github.com/jinzcdev/markmap-mcp-server
- Owner: jinzcdev
- License: mit
- Created: 2025-04-28T12:53:55.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-06-12T10:53:56.000Z (10 months ago)
- Last Synced: 2025-11-01T01:07:41.948Z (5 months ago)
- Topics: ai, llm, markmap, mcp, mcp-server, mindmap, mindnode, xmind
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@jinzcdev/markmap-mcp-server
- Size: 195 KB
- Stars: 133
- Watchers: 2
- Forks: 22
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp - jinzcdev/markmap-mcp-server
- awesome-mcp-servers - jinzcdev/markmap-mcp-server - [markmap](https://github.com/markmap/markmap) を基にしたMCPサーバーで、**Markdown**をインタラクティブな**マインドマップ**に変換します。複数のフォーマット（PNG/JPG/SVG）でのエクスポート、ブラウザでのリアルタイムプレビュー、ワンクリックでのMarkdownコピー、ダイナミックな視覚化機能をサポートしています。 (サーバー実装 / 🧠 <a name="knowledge--memory"></a>知識と記憶)
- awesome-mcp-servers - Markmap MCP Server - An MCP server that converts Markdown into interactive markmap-based mind maps, with support for multiple export formats. Useful as an MCP tool for visualizing and exploring Markdown content via mind maps within MCP-compatible clients. ([Read more](/details/markmap-mcp-server.md)) `markdown` `interactive` `visualization` (Data Visualization)
- best-of-mcp-servers - GitHub
- toolsdk-mcp-registry - ✅ @jinzcdev/markmap-mcp-server - format export capabilities for visualizing hierarchical information. (1 tools) (node) (Other Tools and Integrations / How to Submit)
- awesome-mcp-servers - **jinzcdev/markmap-mcp-server 📇 🏠** - An MCP server built on markmap that converts Markdown to interactive mind maps. Supports multi-format exports (PNG/JPG/SVG), live browser preview, one-click Markdown copy, and dynamic visualization features. `http` `git` `github` (📦 Other)
- awesome-mcp-servers - jinzcdev/markmap-mcp-server - [markmap](https://github.com/markmap/markmap) を基にしたMCPサーバーで、**Markdown**をインタラクティブな**マインドマップ**に変換します。複数のフォーマット（PNG/JPG/SVG）でのエクスポート、ブラウザでのリアルタイムプレビュー、ワンクリックでのMarkdownコピー、ダイナミックな視覚化機能をサポートしています。 (サーバー実装 / 🧠 <a name="knowledge--memory"></a>知識と記憶)
- metorial-index - Markmap - Converts Markdown text into interactive mind maps, supporting export in various image formats including PNG, JPG, and SVG. Features include zooming, node expansion, automatic browser preview, and one-click Markdown copying. (Content Creation)
README
# Markmap MCP Server
[](https://www.npmjs.com/package/@jinzcdev/markmap-mcp-server)
[](LICENSE)
[](https://smithery.ai/server/@jinzcdev/markmap-mcp-server)
[](README_zh-CN.md)
[](https://github.com/jinzcdev/markmap-mcp-server)
Markmap MCP Server is based on the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) that allows one-click conversion of Markdown text to interactive mind maps, built on the open source project [markmap](https://github.com/markmap/markmap). The generated mind maps support rich interactive operations and can be exported in various image formats.
> 🎉 **Explore More Mind Mapping Tools**
>
> Try [MarkXMind](https://github.com/jinzcdev/markxmind) - An online editor that creates complex mind maps using simple XMindMark syntax. It supports real-time preview, multi-format export (.xmind/.svg/.png), importing existing XMind files. [Try it now](https://markxmind.js.org/)!
## Features
- 🌠 **Markdown to Mind Map**: Convert Markdown text to interactive mind maps
- 🖼️ **Multi-format Export**: Support for exporting as PNG, JPG, and SVG images
- 🔄 **Interactive Operations**: Support for zooming, expanding/collapsing nodes, and other interactive features
- 📋 **Markdown Copy**: One-click copy of the original Markdown content
- 🌐 **Automatic Browser Preview**: Option to automatically open generated mind maps in the browser
## Prerequisites
1. Node.js (v20 or above)
## Installation
### Installing via Smithery
To install Markmap MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@jinzcdev/markmap-mcp-server):
```bash
npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude
```
### Manual Installation
```bash
# Install from npm
npm install @jinzcdev/markmap-mcp-server -g
# Basic run
npx -y @jinzcdev/markmap-mcp-server
# Specify output directory
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory
```
Alternatively, you can clone the repository and run locally:
```bash
# Clone the repository
git clone https://github.com/jinzcdev/markmap-mcp-server.git
# Navigate to the project directory
cd markmap-mcp-server
# Build project
npm install && npm run build
# Run the server
node build/index.js
```
## Usage
Add the following configuration to your MCP client configuration file:
```json
{
"mcpServers": {
"markmap": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@jinzcdev/markmap-mcp-server"],
"env": {
"MARKMAP_DIR": "/path/to/output/directory"
}
}
}
}
```
> [!TIP]
>
> The service supports the following environment variables:
>
> - `MARKMAP_DIR`: Specify the output directory for mind maps (optional, defaults to system temp directory)
>
> **Priority Note**:
>
> When both the `--output` command line argument and the `MARKMAP_DIR` environment variable are specified, the command line argument takes precedence.
## Available Tools
### markdown-to-mindmap
Convert Markdown text into an interactive mind map.
**Parameters:**
- `markdown`: The Markdown content to convert (required string)
- `open`: Whether to automatically open the generated mind map in the browser (optional boolean, default is false)
**Return Value:**
```json
{
"content": [
{
"type": "text",
"text": "JSON_DATA_OF_MINDMAP_FILEPATH"
}
]
}
```
## License
This project is licensed under the [MIT](./LICENSE) License.