\n \n \n
\n \n
\n \n\n```\n\n*Visualization options:* (If formulas or symbols don\u2019t display correctly, download the HTML file and open it in a browser.)\n1. View the mindmap in artifacts (if available):\n![system_prompt_artifact](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-05-20/1i9LIfoVRdCV97HM.png)\n\n2. Render the HTML file as a mindmap:\n![system_prompt_render](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-05-20/qv4ActvFaphc64oA.png)\n\n\n\n---\n\n## Prerequisites\n\nThis package requires Node.js to be installed when using command `python` or `uvx` to run the server.\n\n## Usage\n\n### With Claude Desktop or other MCP clients\n\nAdd this server to your `claude_desktop_config.json`:\n\n
\n\n using `uvx`:\n\n```json\n{\n \"mcpServers\": {\n \"mindmap\": {\n \"command\": \"uvx\",\n \"args\": [\"mindmap-mcp-server\", \"--return-type\", \"html\"]\n }\n }\n}\n```\n\nor\n\nrecommended:\n\n```json\n{\n \"mcpServers\": {\n \"mindmap\": {\n \"command\": \"uvx\",\n \"args\": [\"mindmap-mcp-server\", \"--return-type\", \"filePath\"]\n }\n }\n}\n```\n\nwe use `--return-type` to specify the return type of the mindmap content, you can choose `html` or `filePath` according to your needs.\n`html` will return the entire HTML content of the mindmap, which you can preview in your AI client's artifact;\n\n![return_html_content](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-20/qAEimhwZJDQ3NBLs.png)\n\n![html_preview](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-21/SujqY2L5lhWSHWvi.png)\n\n`filePath` will save the mindmap to a file and return the file path,which you can open in your browser. It can **save your tokens** !\n\n![generate_file](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-20/WDqlWhsoiAYpLmBF.png)\n\n![file_to_open](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-20/jfRIDc5mfvNtKykC.png)\n\n
\n\n
\nusing `python`:\n\nUsing [a specific Python file](https://github.com/YuChenSSR/mindmap-mcp-server/blob/main/mindmap_mcp_server/server.py) in this repository:\n\n```json\n{\n \"mcpServers\": {\n \"mindmap\": {\n \"command\": \"python\",\n \"args\": [\"/path/to/your/mindmap_mcp_server/server.py\", \"--return-type\", \"html\"]\n }\n }\n}\n```\n\nor\n\n```json\n{\n \"mcpServers\": {\n \"mindmap\": {\n \"command\": \"python\",\n \"args\": [\"/path/to/your/mindmap_mcp_server/server.py\", \"--return-type\", \"filePath\"]\n }\n }\n}\n```\nwe use `--return-type` to specify the return type of the mindmap content, you can choose `html` or `filePath` according to your needs. see using \\`uvx\\` for more details.\n\n
\n\n
\n\nusing `docker`:\n\nFirst, you pull the image:\n\n```bash\ndocker pull ychen94/mindmap-converter-mcp\n```\n\nSecond, set the server:\n\n```json\n{\n \"mcpServers\": {\n \"mindmap-converter\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"--rm\", \"-i\", \"-v\", \"/path/to/output/folder:/output\", \"ychen94/mindmap-converter-mcp:latest\"]\n }\n }\n}\n```\n\u26a0\ufe0f Replace `/path/to/output/folder` with an actual path on your system where you want to save mind maps, such as `/Users/username/Downloads` on macOS or `C:\\\\Users\\\\username\\\\Downloads` on Windows.\n\n**Tools Provided in the docker container**\nThe server provides the following MCP tools:\n1. **markdown-to-mindmap-content**\nConverts Markdown to an HTML mind map and returns the entire HTML content.\nYou don't use the args: `-v` and `/path/to/output/folder:/output` in the command `docker`.\n**Parameters**:\n\t\u2022\tmarkdown (string, required): The Markdown content to convert\n\t\u2022\ttoolbar (boolean, optional): Whether to show the toolbar (default: true)\n**Best for**: Simple mind maps where the HTML content size isn't a concern. And you can use **artifact** in your AI client to preview the mindmap.\n2. **markdown-to-mindmap-file**\nConverts Markdown to an HTML mind map and saves it to a file in the mounted directory.\n**Parameters**:\n\t\u2022\tmarkdown (string, required): The Markdown content to convert\n\t\u2022\tfilename (string, optional): Custom filename (default: auto-generated timestamp name)\n\t\u2022\ttoolbar (boolean, optional): Whether to show the toolbar (default: true)\n**Best for**: Complex mind maps or when you want to **save the tokens** for later use.\nyou can open the html file in your browser to view the mindmap. Also you can use the [iterm-mcp-server](https://github.com/ferrislucas/iterm-mcp) or other terminals' mcp servers to open the file in your browser without interrupting your workflow.\n\n
\n\n### Troubleshooting\n\n**File Not Found**\nIf your mind map file isn't accessible:\n\t1\tCheck that you've correctly mounted a volume to the Docker container\n\t2\tEnsure the path format is correct for your operating system\n\t3\tMake sure Docker has permission to access the directory\n\n**Docker Command Not Found**\n\t1\tVerify Docker is installed and in your PATH\n\t2\tTry using the absolute path to Docker\n\n**Server Not Appearing in Claude**\n\t1\tRestart Claude for Desktop after configuration changes\n\t2\tCheck Claude logs for connection errors\n\t3\tVerify Docker is running\n\n**Advanced Usage\nUsing with Other MCP Clients**\nThis server works with any MCP-compatible client, not just Claude for Desktop. The server implements the Model Context Protocol (MCP) version 1.0 specification.\n\n## Features\n\nThis server provides a tool for converting Markdown content to mindmaps using the `markmap-cli` library:\n\n- Convert Markdown to interactive mindmap HTML\n- Option to create offline-capable mindmaps\n- Option to hide the toolbar\n- Return either HTML content or file path\n\n## Example\n\nIn Claude, you can ask:\n\n1.\n\"**give a mindmap for the following markdown code, using a mindmap tool:**\n```\n# Project Planning\n## Research\n### Market Analysis\n### Competitor Review\n## Design\n### Wireframes\n### Mockups\n## Development\n### Frontend\n### Backend\n## Testing\n### Unit Tests\n### User Testing\n```\n\"\n\nif you want to save the mindmap to a file, and then open it in your browser using the iTerm MCP server:\n\n2.\n\"**give a mindmap for the following markdown input_code using a mindmap tool,\nafter that,use iterm to open the generated html file.\ninput_code:**\n```\nmarkdown content\n```\n\"\n\n3.\n\"**Think about the process of putting an elephant into a refrigerator, and provide a mind map. Open it with a terminal.**\"\n\n
\n\nsee the result\n\n![aiworkflow](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-22/QUjGnpmUcPfd3lBI.png)\n\n![mindmapinbrowser](https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-22/w7DZ4shFhLoQZruq.png)\n\n
\n\n**and more**\n\n## License\n\nThis project is licensed under the MIT License.\nFor more details, please see the LICENSE file in [this project repository](https://github.com/YuChenSSR/mindmap-mcp-server)\n\n---\n\nIf this project is helpful to you, please consider giving it a Star \u2b50\ufe0f\n\nThe advancement of technology ought to benefit all individuals rather than exploit the general populace.", "installation_instructions": null, "categories": [ "Everything", "Service Connectors", "Platform Tools & Security" ], "owners": [], "owner": null, "code_snippets": { "status": "published", "package_name": "mseep-mindmap-mcp-server", "package_type": "pypi", "published_url": "https://pypi.org/project/mseep-mindmap-mcp-server", "package_version": "0.1.4", "macos_audit_passed": false }, "evaluation_results": [], "found_via_ownership_request": false, "security_scans": [ { "repo_url": "https://github.com/YuChenSSR/mindmap-mcp-server", "repo_name": "mindmap-mcp-server", "score": 99, "risk_level": "low", "score_explanation": "Score starts at 100, deducts points for security issues, and adds points for security best practices", "scan_id": "6667834e-81f2-4b58-b7c4-81f4fe9043a6", "mcp_app_id": "4b2d53bc-60dd-4cf6-a3b0-1574520943e3", "scan_time": "2025-04-11T20:40:08.774479+00:00", "created_at": "2025-04-11T20:40:08.774835+00:00", "updated_at": "2025-04-11T20:40:08.774837+00:00", "findings": [ { "finding_id": "16bf0292-66df-4d54-aeaf-e8e155023645", "message": "Potentially unsafe file access. Make sure the filename is properly validated.", "line": 33, "created_at": "2025-04-11T20:40:08.775604+00:00", "rule_id": "security-validator.scanner.rules.semgrep.dangerous-file-access", "scan_id": "6667834e-81f2-4b58-b7c4-81f4fe9043a6", "type": "semgrep", "severity": "WARNING", "path": "mindmap-mcp-server/mindmap_mcp_server/server.py", "meta_info": { "lines": " with open(file_path, mode='w') as f:", "pattern": "", "rule_name": "file_access" } }, { "finding_id": "b19b0042-51f3-4447-a81e-e5c4090717ff", "message": "Potentially unsafe file access. Make sure the filename is properly validated.", "line": 66, "created_at": "2025-04-11T20:40:08.775608+00:00", "rule_id": "security-validator.scanner.rules.semgrep.dangerous-file-access", "scan_id": "6667834e-81f2-4b58-b7c4-81f4fe9043a6", "type": "semgrep", "severity": "WARNING", "path": "mindmap-mcp-server/mindmap_mcp_server/server.py", "meta_info": { "lines": " with open(file_path, 'r', encoding='utf-8') as f:", "pattern": "", "rule_name": "file_access" } } ], "vulnerabilities": [] }, { "repo_url": "https://github.com/YuChenSSR/mindmap-mcp-server", "repo_name": "mindmap-mcp-server", "score": 100, "risk_level": "low", "score_explanation": "Score starts at 100, deducts points for security issues, and adds points for security best practices", "scan_id": "e4b288db-b3ed-4f4b-ae51-8af4b69697e5", "mcp_app_id": "4b2d53bc-60dd-4cf6-a3b0-1574520943e3", "scan_time": "2025-04-29T14:23:46.275104+00:00", "created_at": "2025-04-29T14:23:46.275618+00:00", "updated_at": "2025-04-29T14:23:46.275620+00:00", "findings": [], "vulnerabilities": [] }, { "repo_url": "https://github.com/YuChenSSR/mindmap-mcp-server", "repo_name": "mindmap-mcp-server", "score": 100, "risk_level": "low", "score_explanation": "Score starts at 100, deducts points for security issues, and adds points for security best practices", "scan_id": "87960f68-242b-4ed8-8ca3-a773efc96f21", "mcp_app_id": "4b2d53bc-60dd-4cf6-a3b0-1574520943e3", "scan_time": "2025-06-13T14:28:52.868797+00:00", "created_at": "2025-06-13T14:28:52.869518+00:00", "updated_at": "2025-06-13T14:28:52.869518+00:00", "findings": [], "vulnerabilities": [] } ] } }