Позвольте ИИ-ассистентам создавать, редактировать и структурировать интеллект-карты прямо в приложении Mind Elixir Desktop.
Также известен как mind-elixir/mcp, mcp, @mind-elixir/mcp
- Звёзды
- 1
- Инструменты
- 11
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.5
- Последний коммит
- 15 сент. 2026 г.
- Лицензия
- MIT
Что такое Mind Elixir MCP?
Позвольте ИИ-ассистентам создавать, редактировать и структурировать интеллект-карты прямо в приложении Mind Elixir Desktop. Он предоставляет 11 инструментов, например mindmap_data, node_id, topic.
Сводка сгенерирована из README проекта
О Mind Elixir MCP server
Mind Elixir MCP Server служит мостом между ИИ-ассистентами и приложением Mind Elixir Desktop. Он позволяет подключать клиенты, работающие только через stdio, такие как Claude Desktop, Cursor, VS Code и Windsurf, к десктопному приложению путем перенаправления вызовов инструментов на локальный HTTP-эндпоинт. Такая конфигурация дает ИИ возможность напрямую взаимодействовать с интеллект-картами, над которыми вы работаете в десктопном ПО.
Пользователи могут управлять своими визуальными структурами с помощью семи специализированных инструментов. Эти инструменты позволяют ассистенту создавать совершенно новые карты, переименовывать существующие темы, добавлять дочерние узлы и даже рисовать стрелки с подписями между удаленными узлами для отображения связей. Сервер также поддерживает расширенные функции организации, такие как добавление узлов-резюме для сворачивания групп соседних узлов в одну общую идею.
Для использования этого решения на вашем компьютере должны быть установлены и запущены Mind Elixir Desktop. По умолчанию мост подключается к приложению через порт 6595. Хотя мост берет на себя преобразование из stdio в HTTP, клиенты, способные устанавливать прямые соединения через Streamable HTTP, могут обойти мост и подключиться к десктопному приложению напрямую.
Что вы можете с ним делать
- 1Преобразование документов в картыИИ может трансформировать длинный текстовый документ или диалог в структурированную визуальную интеллект-карту.
- 2Организация структур проектовРазработчик может поручить ассистенту разбить сложный проект на формальную структуру декомпозиции работ.
- 3Обобщение тем встречВы можете использовать ассистента для извлечения и картирования основных тем из транскрипта встречи.
- 4Улучшение существующих заметокИИ может реорганизовать и упорядочить заметки, которые вы создавали вручную ранее.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Mind Elixir MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Mind Elixir MCP в Claude Code
$ claude mcp add mcp -- npx -y @mind-elixir/mcpУстановка Mind Elixir MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@mind-elixir/mcp"
]
}
}
}Установка Mind Elixir MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mind-elixir/mcp"
]
}
}
}Установка Mind Elixir MCP в VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@mind-elixir/mcp"]}'Установка Mind Elixir MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@mind-elixir/mcp"
]
}
}
}Установка Mind Elixir MCP в Codex
$ codex mcp add mcp -- npx -y @mind-elixir/mcpУстановка Mind Elixir MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@mind-elixir/mcp"]
Установка Mind Elixir MCP в Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @mind-elixir/mcpУстановка Mind Elixir MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@mind-elixir/mcp"
]
}
}
}Инструменты Mind Elixir MCP 11
Определено из READMEmindmap_datanode_idtopicparent_idtextparentstartendlabelfrombidirectional
| mindmap_data | — | |
| node_id | — | |
| topic | — | |
| parent_id | — | |
| text | — | |
| parent | — | |
| start | — | |
| end | — | |
| label | — | |
| from | — | |
| bidirectional | — |
Конфигурация
MIND_ELIXIR_MCP_URLTarget URL of the Mind Elixir Desktop MCP endpoint. Defaults to http://127.0.0.1:6595/mcp
| Название | Описание | Тип |
|---|---|---|
| MIND_ELIXIR_MCP_URL | Target URL of the Mind Elixir Desktop MCP endpoint. Defaults to http://127.0.0.1:6595/mcp |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийmind-elixir/mcp is public and reachablegithub.com/mind-elixir/mcp ↗Пройдено
- Пакет указывает этот репозиторий как источник@mind-elixir/mcp names mind-elixir/mcp as sourcenpmjs.com/package/@mind-elixir/mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-09-15github.com/mind-elixir/mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @mind-elixir/mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях99 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели11 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubMind 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: https://app.mind-elixir.com/blog/use-mcp
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
A running bridge prints nothing to stdout (that channel is reserved for JSON-RPC) and stays in the foreground. Diagnostics go to stderr. Quit it with Ctrl+C.
To install the CLI globally instead:
npm install -g @mind-elixir/mcp
mind-elixir-mcp
Then configure your MCP client — see the next section.
Client configuration
Claude Desktop
Edit claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"mind-elixir": {
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest"]
}
}
}
Restart Claude Desktop after saving.
Claude Code
claude mcp add mind-elixir -- npx -y @mind-elixir/mcp@latest
Cursor
Create or edit ~/.cursor/mcp.json (or use Settings → Features → MCP → + Add New MCP Server):
{
"mcpServers": {
"mind-elixir": {
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest"]
}
}
}
VS Code (GitHub Copilot agent mode)
Add to .vscode/mcp.json in your workspace, or to your user-level mcp.json:
{
"servers": {
"mind-elixir": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest"]
}
}
}
Cline, Roo Code, Windsurf
These extensions share the mcpServers shape used by Cursor:
{
"mcpServers": {
"mind-elixir": {
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest"]
}
}
}
Non-default port
If Mind Elixir Desktop is listening somewhere other than 6595, pass the port through:
{
"mcpServers": {
"mind-elixir": {
"command": "npx",
"args": ["-y", "@mind-elixir/mcp@latest", "--port", "7000"]
}
}
}
Connecting without the bridge (HTTP)
If your client can talk Streamable HTTP directly, skip this package entirely and point it at the app:
{
"mcpServers": {
"mind-elixir": {
"type": "http",
"url": "http://127.0.0.1:6595/mcp"
}
}
}
The app exposes:
| Endpoint | Method | Purpose |
|---|---|---|
/mcp |
POST / GET |
MCP Streamable HTTP endpoint (the one you want). |
/ping |
GET |
Liveness probe; returns pong. |
CORS is enabled for the Mind Elixir Cloud origin, so browser-hosted clients can call the local server too.
Tools reference
All tools return a plain-text result. Successful mutations answer with OK (or, for add_child, the new node's ID); failures come back as a string beginning with Error:.
| Tool | Purpose | Returns |
|---|---|---|
new_mindmap |
Create a blank map and switch the app to the editor | OK |
get_all_nodes |
Read the whole current map | Node tree JSON |
generate_mindmap |
Replace the current map from structured data | OK |
edit_topic |
Rename a node | OK |
add_child |
Add a child node | Done. New Node's ID is <id>. |
add_node_summary |
Summarise a range of siblings | OK |
add_arrow |
Connect two nodes with a labelled arrow | OK |
Every tool has a 15-second operation budget. If the app does not report back in time, the tool returns Timeout waiting for mindmap operation to complete.
new_mindmap
Creates a new, empty mind map and navigates the app to its editor page.
No parameters.
get_all_nodes
Returns the current map as a nested node tree — every topic, its ID, and its children.
No parameters. Shape of the response:
{
"topic": "Root Topic",
"id": "1",
"children": [
{ "topic": "Child Topic", "id": "b3f1c0e2-…", "children": [] }
]
}
Always call this before editing or adding to a map you did not create in this session — IDs are the only way to address nodes.
generate_mindmap
Replaces the entire current map with the structure you supply.
| Parameter | Type | Description |
|---|---|---|
mindmap_data |
string | A JSON string with a nodeData root object. |
{
"nodeData": {
"topic": "Root Topic",
"id": "1",
"children": [
{ "topic": "Child Topic 1", "id": "1-1", "children": [] },
{ "topic": "Child Topic 2", "id": "1-2" }
]
}
}
Requirements:
- Every node needs
topic(string) andid(string). childrenis optional.- Use hierarchical numbering (
1,1-1,1-2,2,2-1, …) so later tools can address nodes predictably.
edit_topic
Changes a node's text in place, preserving its position, children, summaries, and arrows.
| Parameter | Type | Description |
|---|---|---|
node_id |
string | ID of the node to rename, e.g. 1, 1-1, or a UUID. |
topic |
string | The new topic text. |
Returns Error: Node not found if node_id does not exist — call get_all_nodes to refresh your view.
add_child
Adds a child node under an existing parent. The app generates the ID, so the result carries it.
| Parameter | Type | Description |
|---|---|---|
parent_id |
string | ID of the parent node. |
topic |
string | Topic text for the new child. |
Returns Done. New Node's ID is <id>. — keep that ID if you plan to edit the node later. Returns Error: Parent node not found when the parent is missing.
add_node_summary
Attaches a summary node that consolidates a contiguous range of a parent's children.
| Parameter | Type | Description |
|---|---|---|
text |
string | The summary text. |
parent |
string | ID of the parent whose children are being summarised. |
start |
integer | Zero-based index of the first child to include. |
end |
integer | Zero-based index of the last child to include (inclusive). |
Example — summarise the first three children of node 1:
{ "text": "These three all concern onboarding", "parent": "1", "start": 0, "end": 2 }
add_arrow
Draws a labelled connection between two nodes, for relationships the tree cannot express.
| Parameter | Type | Description |
|---|---|---|
label |
string | Text shown on or near the arrow, e.g. leads to, depends on. |
from |
string | ID of the source node. |
to |
string | ID of the target node. |
bidirectional |
boolean | true for ↔, false for →. |
Recommended agent workflow
- Orient first. Call
get_all_nodesto learn the real IDs and structure before touching anything. Never assume an ID. - Decide between build and patch. For a brand-new map use
generate_mindmapwith hierarchical IDs. For incremental work on an existing map useadd_childandedit_topic. - Capture generated IDs.
add_childreturns a UUID — record it if the node will be edited again. - Do not rely on the app being on the editor page. Any tool call brings the app to the front and opens the editor; if it was not already editing a map, a new blank map is created first. So always confirm the current state with
get_all_nodesbefore a write. - Keep calls sequential. Mutations are applied in order, and there is no undo exposed over MCP.
CLI reference
USAGE:
npx -y @mind-elixir/mcp [options]
OPTIONS:
-u, --url <url> Target Mind Elixir MCP URL (default: http://127.0.0.1:6595/mcp)
-p, --port <port> Change target port (default: 6595)
-t, --transport <sse|http> Force transport mode ('sse' or 'http', default: auto)
-v, --version Show version
-h, --help Show this help message
ENVIRONMENT VARIABLES:
MIND_ELIXIR_MCP_URL Target URL to connect to
The package installs two equivalent binaries: mind-elixir-mcp and mcp.
Transport selection in auto mode: if the target URL path ends with /mcp, Streamable HTTP is used; otherwise the bridge falls back to the legacy SSE transport. Force one with --transport.
How it works
+--------------------------+
| Claude Desktop / Cursor |
+------------+-------------+
| stdio (stdin / stdout), JSON-RPC
v
+------------+-------------+
| @mind-elixir/mcp | bridge process
+------------+-------------+
| Streamable HTTP -> http://127.0.0.1:6595/mcp
v
+------------+-------------+
| Mind Elixir Desktop | Tauri app, owns the tools
+--------------------------+
- The bridge translates stdio JSON-RPC messages into HTTP requests and streams responses back verbatim.
- Startup is tolerant. If the app is still booting, messages are buffered and replayed in strict FIFO order once the connection is established. The bridge retries the connection three times, one second apart.
- Protocol version is negotiated. The bridge starts at
2024-11-05and adopts whatever version theinitializehandshake settles on, forwarding it to the app. - Failures are explicit. If the app never becomes reachable, every buffered request receives a JSON-RPC error (
-32000) readingMind Elixir Desktop is not running. Please open Mind Elixir Desktop and try again. (<url>),stderrgets a human-readable explanation, and the process exits with code1. Errors raised during an operation are returned to the caller as their original message rather than being swallowed.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
Mind Elixir Desktop is not running |
Launch the desktop app, then reconnect the MCP server in your client. |
Tool call returns Timeout waiting for mindmap operation to complete |
The app did not respond within 15 s — usually a modal dialog or a busy window. Bring the app to the front and retry. |
Connection refused on 6595 |
The port is taken by another process, or the app is on a different port. Restart the app, or pass --port <port> / set MIND_ELIXIR_MCP_URL. |
| The client lists no tools | Confirm the bridge starts by running npx -y @mind-elixir/mcp@latest in a terminal, then restart the client so it re-reads its MCP config. |
| A blank map appeared unexpectedly | The app was not on an editor page when a tool ran, so it created one. Read the map with get_all_nodes before writing. |
Error: Node not found / Error: Parent node not found |
The ID is stale or comes from a different map. Re-read with get_all_nodes. |
| Nothing appears in the client's log | All bridge diagnostics go to stderr; stdout carries protocol traffic only. |
Security and privacy
- The app's MCP server binds
127.0.0.1only — it is never exposed to your network, and it has no authentication. Any local process on your machine can drive the app through it, so treat port6595like any other local control surface. - The bridge is a local child process of your MCP client. It reads and writes nothing on disk; the only network traffic is the loopback HTTP call to the app.
- Everything happens on your machine. No mind map content, prompt, or telemetry is sent to a server by this package or by the desktop app's MCP endpoint.
- Grant the server the same care you would give any tool that edits your documents: it can rewrite the map you have open. Prefer clients configured to ask before running tools when you are working on something important.
Development
Requires Node.js 18+ and pnpm 11+ (the allowBuilds entry in pnpm-workspace.yaml depends on it).
pnpm install
pnpm build # tsup -> dist/index.js
pnpm dev # tsup --watch
The build emits a single bundled ESM file with a #!/usr/bin/env node shebang; prepublishOnly rebuilds before every npm publish.
License
MIT © Mind Elixir
Вопросы о Mind Elixir MCP
Как добавить Mind Elixir MCP в Claude Code?
Выполните claude mcp add mcp -- npx -y @mind-elixir/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Mind Elixir MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет Mind Elixir MCP?
Он предоставляет 11 инструментов, включая mindmap_data, node_id, topic, parent_id, text.
Какие требования необходимы для использования этого сервера?
У вас должны быть установлены и запущены Mind Elixir Desktop, Node.js версии 18 или выше, а также MCP-клиент с поддержкой stdio или Streamable HTTP.
Что именно ИИ-ассистент может делать с моей интеллект-картой?
Ассистент может создавать новые карты, просматривать все узлы и связи, переименовывать узлы, добавлять дочерние узлы, прикреплять узлы-резюме и рисовать стрелки с подписями между узлами.