作者 jinzcdev · jinzcdev/markmap-mcp-server
通过一个工具调用将任何Markdown大纲转换为交互式思维导图—平移、折叠、导出PNG/JPG/SVG。
markmap-mcp-server将开源标记映射渲染器包装为MCP工具。使用嵌套的标题或项目符号列表向其提供Markdown ，获取在浏览器中打开的HTML思维导图（可自动启动）并导出到PNG/JPG/SVG。对于会议摘要、头脑风暴捕获、研究笔记以及任何时候更容易将平面轮廓视为一棵树都很有用。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"markmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
],
"env": {
"MARKMAP_DIR": "/path/to/output"
}
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"markmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
],
"env": {
"MARKMAP_DIR": "/path/to/output"
}
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"markmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
],
"env": {
"MARKMAP_DIR": "/path/to/output"
}
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"markmap-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
],
"env": {
"MARKMAP_DIR": "/path/to/output"
}
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "markmap-mcp-server",
"command": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"markmap-mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"@jinzcdev/markmap-mcp-server"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add markmap-mcp-server -- npx -y @jinzcdev/markmap-mcp-server一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 会议结束后，扁平项目符号列表隐藏了讨论的形状。
结果： 可共享的思维导图，可编码会议的形状，而不仅仅是其文字。
何时使用： 您已经阅读了一个章节，并希望在考试前查看单个图像视觉效果。
结果： 扫描需要几秒钟的视觉学习辅助工具。
何时使用： 您想要一个2分钟的“谈话轨道”图表，而不是一个精美的架构文档。
结果： 几分钟内的通话轨道图；仅在需要时才升级到真实的架构图。
阅读长文档，总结为Markdown大纲，呈现为思维导图
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| markdown-to-mindmap | markdown: str, open?: bool | 将嵌套的Markdown大纲转换为交互式思维导图 | 0 |
浏览器未打开设置open = false并手动打开返回的HTML路径；确认已注册默认浏览器。
open $(returned_path) on macOS导出的PNG为空导出之前，请等待地图完全渲染。增加配置延迟或两次运行导出。
Open the HTML in a browser and check it renders before export写入MARKMAP_DIR的权限被拒绝将MARKMAP_DIR指向主目录中的可写路径。
touch $MARKMAP_DIR/.probe && rm $MARKMAP_DIR/.probe| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| mermaid-skill | 您的数据是流程或序列，而不是层次结构 | 不同的图表范式 |
| excalidraw-skill | 您想要手绘草图视觉效果 | 无自动布局；手动定位 |
| antv-chart | 你需要统计图表，而不是思维导图 | 不同的输出类别 |