{"id":27256063,"url":"https://github.com/yuchenssr/mindmap-mcp-server","last_synced_at":"2025-04-11T02:49:13.128Z","repository":{"id":283318417,"uuid":"951261036","full_name":"YuChenSSR/mindmap-mcp-server","owner":"YuChenSSR","description":"mindmap, mcp server, artifact","archived":false,"fork":false,"pushed_at":"2025-04-02T13:30:22.000Z","size":65,"stargazers_count":35,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T14:31:21.003Z","etag":null,"topics":["artifact","mcp-server","mindmap"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YuChenSSR.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-19T12:05:58.000Z","updated_at":"2025-04-02T13:30:26.000Z","dependencies_parsed_at":"2025-03-20T02:15:46.803Z","dependency_job_id":null,"html_url":"https://github.com/YuChenSSR/mindmap-mcp-server","commit_stats":null,"previous_names":["yuchenssr/mindmap-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuChenSSR%2Fmindmap-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuChenSSR%2Fmindmap-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuChenSSR%2Fmindmap-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuChenSSR%2Fmindmap-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YuChenSSR","download_url":"https://codeload.github.com/YuChenSSR/mindmap-mcp-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248332659,"owners_count":21086107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["artifact","mcp-server","mindmap"],"created_at":"2025-04-11T02:49:12.550Z","updated_at":"2025-04-11T02:49:13.097Z","avatar_url":"https://github.com/YuChenSSR.png","language":"Python","funding_links":[],"categories":["Knowledge \u0026 Memory"],"sub_categories":["How to Submit"],"readme":"# Mindmap MCP Server\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/YuChenSSR/pics/master/imgs/2025-03-21/JMi7Mn89Hw5ikd9z.jpeg\" alt=\"mindmap_mcp\" width=\"50%\"\u003e\n\u003c/p\u003e\n\nA Model Context Protocol (MCP) server for converting Markdown content to interactive mindmaps.\n\n\n\n## Installation\n\n```bash\npip install mindmap-mcp-server\n```\n\nOr using `uvx`:\n\n```bash\nuvx mindmap-mcp-server\n```\nOr using `docker` safer and easier.\n\n## Prerequisites\n\nThis package requires Node.js to be installed when using command `python` or `uvx` to run the server.\n\n\n\n## Usage\n\n### With Claude Desktop or other MCP clients\n\nAdd this server to your `claude_desktop_config.json`:\n\n\u003cdetails\u003e\n \n \u003csummary\u003eusing `uvx`:\u003c/summary\u003e\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\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\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eusing `python`:\u003c/summary\u003e\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\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\u003c/details\u003e\n\n\u003cdetails\u003e\n\n\u003csummary\u003eusing `docker`:\u003c/summary\u003e\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⚠️ 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•\tmarkdown (string, required): The Markdown content to convert  \n\t•\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•\tmarkdown (string, required): The Markdown content to convert  \n\t•\tfilename (string, optional): Custom filename (default: auto-generated timestamp name)  \n\t•\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\u003c/details\u003e\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\n## Attention\n\nThree installation methods have been successfully tested on macOS and Linux. \n\nFor Windows users experiencing issues with `npx` for this MCP, consider using the Docker method. Alternatively, if you use Visual Studio Code, the [\"Markmap\"](https://marketplace.visualstudio.com/items?itemName=gera2ld.markmap-vscode) extension offers a potentially simpler solution than navigating command-line tools.\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\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\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\u003cdetails\u003e\n\t\n\u003csummary\u003esee the result\u003c/summary\u003e\n\t\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 \u003c/details\u003e\n\n \n**and more**\n\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 ⭐️\n\nThe advancement of technology ought to benefit all individuals rather than exploit the general populace.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuchenssr%2Fmindmap-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuchenssr%2Fmindmap-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuchenssr%2Fmindmap-mcp-server/lists"}