# MarkMap-MCP服务器
## 基本信息
- Slug: `jinzcdev-markmap-mcp-server`
- Source: modelscope
- Publisher: @jinzcdev/markmap-mcp-server
- Categories: developer-tools / content-management-systems
- Hosted: Yes
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@jinzcdev/markmap-mcp-server
## 简介
一个模型上下文协议服务器，可将Markdown文本转换为支持丰富交互操作和多格式导出的交互式思维导图。
## MCP Server 详情

# Markmap MCP 服务器

![示例思维导图](./docs/markmap.svg)

[![NPM 版本](https://img.shields.io/npm/v/@jinzcdev/markmap-mcp-server.svg)](https://www.npmjs.com/package/@jinzcdev/markmap-mcp-server)
[![GitHub 许可证](https://img.shields.io/github/license/jinzcdev/markmap-mcp-server.svg)](LICENSE)
[![Smithery 徽章](https://smithery.ai/badge/@jinzcdev/markmap-mcp-server)](https://smithery.ai/server/@jinzcdev/markmap-mcp-server)
[![中文文档](https://img.shields.io/badge/中文文档-点击查看-blue)](README_zh-CN.md)
[![Stars](https://img.shields.io/github/stars/jinzcdev/markmap-mcp-server)](https://github.com/jinzcdev/markmap-mcp-server)

Markmap MCP 服务器基于 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) 构建，允许一键将 Markdown 文本转换为交互式思维导图。该工具基于开源项目 [markmap](https://github.com/markmap/markmap) 构建。生成的思维导图支持丰富的交互操作，并可以导出为多种图像格式。

## 功能

- 🌠 **Markdown 转换为思维导图**：将 Markdown 文本转换为交互式思维导图
- 🖼️ **多格式导出**：支持导出为 PNG、JPG 和 SVG 图像
- 🔄 **交互操作**：支持缩放、展开/折叠节点等交互功能
- 📋 **Markdown 复制**：一键复制原始 Markdown 内容
- 🌐 **自动浏览器预览**：可以选择在浏览器中自动打开生成的思维导图

## 前提条件

1. Node.js 运行环境

## 安装

### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@jinzcdev/markmap-mcp-server) 自动安装适用于 Claude Desktop 的 Markmap MCP 服务器：

bash
npx -y @smithery/cli install @jinzcdev/markmap-mcp-server --client claude


### 手动安装

bash
# 从 npm 安装
npm install @jinzcdev/markmap-mcp-server -g

# 基本运行
npx -y @jinzcdev/markmap-mcp-server

# 指定输出目录
npx -y @jinzcdev/markmap-mcp-server --output /path/to/output/directory


或者，您可以克隆仓库并在本地运行：

bash
# 克隆仓库
git clone https://github.com/jinzcdev/markmap-mcp-server.git

# 进入项目目录
cd markmap-mcp-server

# 构建项目
npm install && npm run build

# 运行服务器
node build/index.js


## 使用方法

在您的 MCP 客户端配置文件中添加以下配置：

json
{
  "mcpServers": {
    "markmap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jinzcdev/markmap-mcp-server",
        "--output",
        "/path/to/output/directory"
      ]
    }
  }
}


> [!TIP]
>
> 服务支持以下环境变量：
>
> - `MARKMAP_DIR`：指定思维导图的输出目录（可选，默认为系统临时目录）
>
> **优先级说明**：
>
> 当同时指定了 `--output` 命令行参数和 `MARKMAP_DIR` 环境变量时，命令行参数优先。

## 可用工具

### markdown-to-mindmap

将 Markdown 文本转换为交互式思维导图。

**参数：**

- `markdown`：要转换的 Markdown 内容（必需字符串）
- `open`：是否在浏览器中自动打开生成的思维导图（可选布尔值，默认为 false）

**返回值：**

json
{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_OF_MINDMAP_FILEPATH"
    }
  ]
}


## 许可证

该项目采用 MIT 许可证。