This is the that connects stdio-only MCP clients — Claude Desktop, Claude Code, Cursor, VS Code, Cline, Roo Code, Windsurf — to the MCP server built into the Mind Elixir Desktop app.
概览
This is the that connects stdio-only MCP clients — Claude Desktop, Claude Code, Cursor, VS Code, Cline, Roo Code, Windsurf — to the MCP server built into the Mind Elixir Desktop app. This server is a local controller for the desktop app, not a standalone cloud service. The bridge forwards tool calls to http://127.0.0.1:6595/mcp and streams the results back. - Registry name: io.github.mind-elixir/mcp - npm package: @mind-elixir/mcp - Setup guide: https://app.mind-elixir.com/blog/use-mcp Seven tools let an assistant read and mutate the mind map that is currently open in the app: - Start a fresh map, or replace the current one with a structure the model designed. - Inspect every topic, node ID, and parent/child relationship in the current map. - Rename nodes, add child nodes, and get back the ID of what was just created. - Attach that collapse a range of siblings into one idea. - Draw between any two nodes to express relationships that the tree cannot.
README
以下为原文 README 节选，完整内容请查看原文。
Mind Elixir MCP Server
Let AI assistants build and edit real mind maps in Mind Elixir Desktop.
This is the stdio ↔ HTTP bridge that connects stdio-only MCP clients — Claude Desktop, Claude Code, Cursor, VS Code, Cline, Roo Code, Windsurf — to the MCP server built into the Mind Elixir Desktop app.
Requires Mind Elixir Desktop to be installed and running. This server is a local controller for the desktop app, not a standalone cloud service. The bridge forwards tool calls to
http://127.0.0.1:6595/mcpand streams the results back.
- Registry name:
io.github.mind-elixir/mcp - npm package:
@mind-elixir/mcp - Setup guide:
Contents
- What you can do with it
- Requirements
- Quick start
- Client configuration
- Connecting without the bridge (HTTP)
- Tools reference
- Recommended agent workflow
- CLI reference
- How it works
- Troubleshooting
- Security and privacy
- Development
- License
What you can do with it
Seven tools let an assistant read and mutate the mind map that is currently open in the app:
- Start a fresh map, or replace the current one with a structure the model designed.
- Inspect every topic, node ID, and parent/child relationship in the current map.
- Rename nodes, add child nodes, and get back the ID of what was just created.
- Attach summary nodes that collapse a range of siblings into one idea.
- Draw labelled arrows between any two nodes to express relationships that the tree cannot.
Typical uses: turning a conversation or a document into a structured map, breaking a project down into a work breakdown structure, summarising a meeting into themes, or having an assistant reorganise notes you already made by hand.
Requirements
| Requirement | Detail |
|---|---|
| Mind Elixir Desktop | Installed and running. The app hosts the actual MCP server on 127.0.0.1:6595. |
| Node.js | 18 or newer — only needed to run the bridge via npx, npm i -g, or a local install. |
| MCP client | Any client that speaks MCP over stdio, or one that can connect directly to a Streamable HTTP endpoint. |
| Port | 6595 must be free on loopback. Override with --port if it is not. |
Quick start
Start Mind Elixir Desktop first, then verify the bridge can reach it:
npx -y @mind-elixir/mcp@latest
安装
npx -y @mind-elixir/mcp@latest配置
{
"mcpServers": {
"mind-elixir": {
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest"]
}
}
}