{"_id":"@41px/mcp-xmind","_rev":"5-a13f35e969497c5176b9a91bef165f1d","name":"@41px/mcp-xmind","dist-tags":{"latest":"2.1.0"},"versions":{"0.1.0":{"name":"@41px/mcp-xmind","version":"0.1.0","author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"license":"MIT","_id":"@41px/mcp-xmind@0.1.0","maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"bin":{"mcp-server-xmind":"dist/index.js"},"dist":{"shasum":"7288f24fad58d8c0a9fd562ce79a892a3747e375","tarball":"https://registry.npmjs.org/@41px/mcp-xmind/-/mcp-xmind-0.1.0.tgz","fileCount":3,"integrity":"sha512-ZLiHpmc/HrCKXHdbteOna3FgV40N3hgYzO/duO2nfoM8WwiTE+mgJe1eQ5a1vO/VASDQrRP9o6CDSSsPYCXu9A==","signatures":[{"sig":"MEYCIQDfMa3mccMqMfzzvjlzBWJEIexCdqnscYvyl+MuTk+fywIhAPdF1HneQQ6492GFKtDX+Fv6DumXyeoNgAsVCMoovoBw","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":31937},"type":"module","gitHead":"40f0bfb0e3391934a279ae9c6533fba20ac1c0f7","scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"41px","email":"alexandre@peyroux.io"},"_npmVersion":"10.9.0","description":"MCP server for XMind","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.1","diff":"^5.1.0","glob":"^10.3.10","adm-zip":"^0.5.16","minimatch":"^10.0.1","zod-to-json-schema":"^3.24.1","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.7.2","@types/diff":"^5.0.9","@types/node":"^20.17.10","@types/adm-zip":"^0.5.7","@types/minimatch":"^5.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xmind_0.1.0_1734015114455_0.7054157215063248","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@41px/mcp-xmind","version":"0.1.1","author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"license":"MIT","_id":"@41px/mcp-xmind@0.1.1","maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"bin":{"mcp-server-xmind":"dist/index.js"},"dist":{"shasum":"e468d369317d148a81777a53b445d2517d32e6fa","tarball":"https://registry.npmjs.org/@41px/mcp-xmind/-/mcp-xmind-0.1.1.tgz","fileCount":3,"integrity":"sha512-lVj9WeqsSoXIrFxa7HEwQe/fahGEvGDaUDB7HSzxKysAxHLffp2xbLOY1NHb8oYWyvPNxAYFKA66opi4kxPvng==","signatures":[{"sig":"MEQCIDIaCO6yuzEUQoMupjBBIEWjH76vdSq+6GWVNzE/6SWIAiAjUdFBqQw25+RcpWGSayogw6NKiQEUSUYeQKevGGjutg==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":31933},"type":"module","gitHead":"fc48fb3a8b68110174409a9827db71a9c9eb7b22","scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"41px","email":"alexandre@peyroux.io"},"_npmVersion":"10.9.0","description":"MCP server for XMind","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.1","diff":"^5.1.0","glob":"^10.3.10","adm-zip":"^0.5.16","minimatch":"^10.0.1","zod-to-json-schema":"^3.24.1","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.7.2","@types/diff":"^5.0.9","@types/node":"^20.17.10","@types/adm-zip":"^0.5.7","@types/minimatch":"^5.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xmind_0.1.1_1734015264930_0.7231508599638878","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@41px/mcp-xmind","version":"1.1.0","author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"license":"MIT","_id":"@41px/mcp-xmind@1.1.0","maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"bin":{"mcp-server-xmind":"dist/index.js"},"dist":{"shasum":"088609511f409ade845819afdbd0b3a4da8521f2","tarball":"https://registry.npmjs.org/@41px/mcp-xmind/-/mcp-xmind-1.1.0.tgz","fileCount":3,"integrity":"sha512-miIUfVHt96jMsUP6ae3qC8y6Wj+HR1rvFlBigpxk+Pd89Y2UTuujlJuKdTLCZXXZSuzwNQ29QoucLYc7G0NTkg==","signatures":[{"sig":"MEUCIEVsn6q5UYulsSCXOfolLCanQsjsHfbNOq8re8WqfO2UAiEApXR6xn851af7N7b3YSMiq+FDFuBdmTFHuYoD2pU/Qt4=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":34407},"type":"module","gitHead":"25d9be4e087be082ae5b3f7c0f00b78c0505db4d","scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"41px","email":"alexandre@peyroux.io"},"_npmVersion":"10.9.0","description":"MCP server for XMind","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.1","diff":"^5.1.0","glob":"^10.3.10","adm-zip":"^0.5.16","minimatch":"^10.0.1","zod-to-json-schema":"^3.24.1","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.7.2","@types/diff":"^5.0.9","@types/node":"^20.17.10","@types/adm-zip":"^0.5.7","@types/minimatch":"^5.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xmind_1.1.0_1734035085801_0.542778455330083","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@41px/mcp-xmind","version":"1.1.1","author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"license":"MIT","_id":"@41px/mcp-xmind@1.1.1","maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"bin":{"mcp-server-xmind":"dist/index.js"},"dist":{"shasum":"451ea483752f18804b3a62cc388d3261ca3f9993","tarball":"https://registry.npmjs.org/@41px/mcp-xmind/-/mcp-xmind-1.1.1.tgz","fileCount":3,"integrity":"sha512-tkdRc4TW6vaILsSadbSdq/nv8l9WUqHbzvhQb/shz0fnBpAol0vVZz7sw7YfRpPv1iS4k92MKN9d1zaVZetDEg==","signatures":[{"sig":"MEUCIH/+JKsTOLtEl5fks3cKMbfz9Z7c2U46l/vTSO9HrnWWAiEAlBJv3IGnnfcM82Ju2Icym3XD3TzL+BMRmm5MA5j64RM=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":32679},"type":"module","gitHead":"ed76052b5d3c4853237f252d22075edf2a8ecd87","scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"41px","email":"alexandre@peyroux.io"},"_npmVersion":"10.9.0","description":"MCP server for XMind","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"^3.24.1","diff":"^5.1.0","glob":"^10.3.10","adm-zip":"^0.5.16","minimatch":"^10.0.1","zod-to-json-schema":"^3.24.1","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"shx":"^0.3.4","typescript":"^5.7.2","@types/diff":"^5.0.9","@types/node":"^20.17.10","@types/adm-zip":"^0.5.7","@types/minimatch":"^5.1.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-xmind_1.1.1_1734039246157_0.13777753531217596","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@41px/mcp-xmind","version":"2.1.0","description":"MCP server for XMind","mcpName":"io.github.apeyroux/mcp-xmind","repository":{"type":"git","url":"git+https://github.com/apeyroux/mcp-xmind.git"},"homepage":"https://github.com/apeyroux/mcp-xmind#readme","keywords":["mcp","xmind","mindmap","model-context-protocol"],"license":"MIT","author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"type":"module","bin":{"mcp-server-xmind":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch","test":"vitest run","test:watch":"vitest"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","adm-zip":"^0.5.16","glob":"^10.3.10","minimatch":"^10.0.1","zod":"^3.25.0"},"devDependencies":{"@types/adm-zip":"^0.5.7","@types/minimatch":"^5.1.2","@types/node":"^20.17.10","shx":"^0.3.4","typescript":"^5.7.2","vitest":"^2.1.0"},"_id":"@41px/mcp-xmind@2.1.0","gitHead":"44070befe97ca6c8dc402927fc2bdd0b6a74a09a","bugs":{"url":"https://github.com/apeyroux/mcp-xmind/issues"},"_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-/P4dAG6RGEbgMjZicWc71ehzYaKLRAIguYO1CTAQrL8wZweSuRC+eyzsK0KrAUJ69QwR2XcZlub02WC24BXDpg==","shasum":"a00b30cb0046072e8a7340fcce85bc99a3c1194d","tarball":"https://registry.npmjs.org/@41px/mcp-xmind/-/mcp-xmind-2.1.0.tgz","fileCount":4,"unpackedSize":56444,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@41px%2fmcp-xmind@2.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDE+pK+wyXjMUcCgn4BomSc8zt8wxKclokkgSG2LXjq+AiA7DRWb6PkhehRfv9N/ds6vzFeEHMnE5s2Or6N54kcYMQ=="}]},"_npmUser":{"name":"41px","email":"alexandre@peyroux.io"},"directories":{},"maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-xmind_2.1.0_1769722718024_0.27655274687496734"},"_hasShrinkwrap":false}},"time":{"created":"2024-12-12T14:51:54.322Z","modified":"2026-01-29T21:38:38.538Z","0.1.0":"2024-12-12T14:51:54.621Z","0.1.1":"2024-12-12T14:54:25.095Z","1.1.0":"2024-12-12T20:24:45.984Z","1.1.1":"2024-12-12T21:34:06.374Z","2.1.0":"2026-01-29T21:38:38.233Z"},"author":{"name":"Alexandre Peyroux","email":"alex@fmap.it"},"license":"MIT","description":"MCP server for XMind","maintainers":[{"name":"41px","email":"alexandre@peyroux.io"}],"readme":"# MCP XMind Server\n\nA Model Context Protocol server for reading, creating and querying XMind mind maps. This tool provides powerful capabilities for searching, extracting, analyzing and generating XMind files.\n\n## Features\n\n### Reading\n- Parse complete mind map structure (multi-sheet)\n- Smart fuzzy search across mind maps\n- Task management and tracking (to-do + planned tasks)\n- Hierarchical content navigation\n- Link and reference extraction (external URLs + internal xmind:# links)\n- Multi-file analysis\n- Label, callout, boundary and summary support\n- Directory scanning\n\n### Writing\n- Create XMind files from structured JSON\n- Nested topics with notes (plain text + HTML formatting)\n- Labels, markers, callouts, boundaries, summaries\n- Relationships between topics (by title)\n- Internal links between topics across sheets (`linkToTopic`)\n- Simple to-do tasks (checkbox)\n- Planned tasks with Gantt support (dates, progress, priority, duration, dependencies)\n- Predefined themes (default, business, dark, simple)\n- Layout structures (clockwise, logic.right, org-chart, fishbone, timeline, etc.)\n- Overwrite protection\n\n### Security\n- Only allows access to specified directories\n- Path normalization and validation\n- Error handling for invalid access attempts\n\n## Installation\n```bash\nnpm install @modelcontextprotocol/sdk adm-zip zod\nnpm install --save-dev typescript @types/node\n```\n\n## Usage\n\n### Starting the Server\n\n```bash\nnode dist/index.js <allowed-directory> [additional-directories...]\n```\n\n### Available Tools\n\n#### Reading Tools\n\n1. **read_xmind** - Parse and extract complete mind map structure\n2. **list_xmind_directory** - Recursively scan for XMind files\n3. **read_multiple_xmind_files** - Process multiple files simultaneously\n4. **search_xmind_files** - Search files by name or content\n5. **extract_node** - Smart fuzzy path matching with ranked results\n6. **extract_node_by_id** - Direct node access by ID\n7. **search_nodes** - Multi-criteria search (title, notes, labels, callouts, tasks)\n\n#### Writing Tools\n\n8. **create_xmind** - Create XMind files from structured data\n\n## Examples\n\n### Read a Mind Map\n```json\n{\n    \"name\": \"read_xmind\",\n    \"arguments\": {\n        \"path\": \"/path/to/file.xmind\"\n    }\n}\n```\n\n### Search for Nodes\n```json\n{\n    \"name\": \"search_nodes\",\n    \"arguments\": {\n        \"path\": \"/path/to/file.xmind\",\n        \"query\": \"project\",\n        \"searchIn\": [\"title\", \"notes\"],\n        \"caseSensitive\": false\n    }\n}\n```\n\n### Create a Mind Map with Planned Tasks\n```json\n{\n    \"name\": \"create_xmind\",\n    \"arguments\": {\n        \"path\": \"/path/to/output.xmind\",\n        \"sheets\": [{\n            \"title\": \"Project Plan\",\n            \"theme\": \"business\",\n            \"rootTopic\": {\n                \"title\": \"Deployment\",\n                \"children\": [\n                    {\n                        \"title\": \"Analysis\",\n                        \"durationDays\": 3,\n                        \"progress\": 0,\n                        \"priority\": 1\n                    },\n                    {\n                        \"title\": \"Development\",\n                        \"durationDays\": 5,\n                        \"progress\": 0,\n                        \"dependencies\": [{\"targetTitle\": \"Analysis\", \"type\": \"FS\"}]\n                    }\n                ]\n            }\n        }]\n    }\n}\n```\n\n### Create Multi-Sheet with Internal Links\n```json\n{\n    \"name\": \"create_xmind\",\n    \"arguments\": {\n        \"path\": \"/path/to/output.xmind\",\n        \"sheets\": [\n            {\n                \"title\": \"Overview\",\n                \"rootTopic\": {\n                    \"title\": \"Project\",\n                    \"linkToTopic\": \"Details Root\",\n                    \"children\": [{\"title\": \"Phase 1\"}, {\"title\": \"Phase 2\"}]\n                }\n            },\n            {\n                \"title\": \"Details\",\n                \"rootTopic\": {\n                    \"title\": \"Details Root\",\n                    \"linkToTopic\": \"Project\",\n                    \"notes\": {\"plain\": \"Detailed view\", \"html\": \"<p><strong>Detailed</strong> view</p>\"}\n                }\n            }\n        ]\n    }\n}\n```\n\n## Configuration\n\n### Claude Desktop\n\nAdd the following to your `claude_desktop_config.json` (on macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n#### Using npx (recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"xmind\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@41px/mcp-xmind\",\n        \"/path/to/your/xmind/files\"\n      ]\n    }\n  }\n}\n```\n\n#### Using a local build\n\n```json\n{\n  \"mcpServers\": {\n    \"xmind\": {\n      \"command\": \"node\",\n      \"args\": [\n        \"/path/to/mcp-xmind/dist/index.js\",\n        \"/path/to/your/xmind/files\"\n      ]\n    }\n  }\n}\n```\n\nRestart Claude Desktop after editing the configuration.\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add xmind -- npx -y @41px/mcp-xmind /path/to/your/xmind/files\n```\n\n## Development\n\n### Building\n```bash\nnpm run build\n```\n\n### Testing\n```bash\nnpm test\n```\n\n### MCP Inspector\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js /path/to/xmind/files\n```\n","readmeFilename":"README.md","homepage":"https://github.com/apeyroux/mcp-xmind#readme","keywords":["mcp","xmind","mindmap","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/apeyroux/mcp-xmind.git"},"bugs":{"url":"https://github.com/apeyroux/mcp-xmind/issues"}}