神经智脑知识系统

Generate knowledge graph (requires graphify)

graphify update .

Install — pick your path

NeuralMind installs five ways. The CLI, semantic indexing, and the MCP server (for Claude Code, Cursor, Cline, Continue, and any MCP client) come in every path.

Verify install:

```bash neuralmind --help # works for every install path

For pip / uv / source (a Python env where neuralmind is importable):

python -c "import neuralmind; print(neuralmind.version)" ```

The python -c line is skipped for pipx and Docker — pipx isolates the package in its own venv, and Docker doesn't expose the in-container Python.

Walkthrough with pros/cons of each path: docs/use-cases/install-paths.md.

Install via any path above, then:

Build neural index

neuralmind build .

(Optional) Install Claude Code PostToolUse compression hooks

neuralmind install-hooks .

(Optional) Auto-rebuild on every git commit

neuralmind init-hook .

`neuralmind build`

Build or incrementally update the neural index from graphify-out/graph.json.

neuralmind build [project_path] [--force]

neuralmind build .
neuralmind build /path/to/project --force

Output: nodes processed, added, updated, skipped, communities indexed, build duration.

---

`neuralmind install-hooks`

Install or remove Claude Code PostToolUse compression hooks.

neuralmind install-hooks [project_path] [--global] [--uninstall]

neuralmind install-hooks .                       # project-scoped
neuralmind install-hooks --global                # all projects
neuralmind install-hooks --uninstall             # remove project hooks
neuralmind install-hooks --uninstall --global    # remove global hooks

---

🚀 Quick Start (humans)

Quick-start by tool

<details> <summary><b>Claude Code</b> — full two-phase optimization</summary>

pip install neuralmind graphifyy
cd your-project
graphify update .
neuralmind build .
neuralmind install-hooks .    # PostToolUse compression
neuralmind init-hook .        # auto-rebuild on commit (optional)

Then use MCP tools in sessions: neuralmind_wakeup, neuralmind_query, neuralmind_skeleton. </details>

<details> <summary><b>Cursor / Cline / Continue</b> — MCP server</summary>

pip install neuralmind graphifyy
graphify update .
neuralmind build .

Add to your MCP config:

{ "mcpServers": { "neuralmind": { "command": "neuralmind-mcp" } } }

<details> <summary><b>ChatGPT / Gemini / any LLM</b> — CLI + copy-paste</summary>

neuralmind wakeup . | pbcopy      # macOS — paste into chat
neuralmind query . "question"     # get context for a specific question

---

Claude Desktop configuration

{
  "mcpServers": {
    "neuralmind": {
      "command": "neuralmind-mcp",
      "args": ["/absolute/path/to/project"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

MCP tool quick reference

---

🖥️ Complete CLI Reference

Startup workflow

Every new session, do this first:

neuralmind wakeup .

Or via MCP:

neuralmind_wakeup(project_path=".")

This returns ~365–600 tokens of structured project context:

• Project name and description (from CLAUDE.md, mempalace.yaml, or README.md first line)
• How many code entities and clusters are indexed
• Architecture overview: top 10 code clusters with their entity types and sample names
• Sections from graphify-out/GRAPH_REPORT.md if present

Use this output as your orientation before writing any code. It replaces reading the entire repository.

---

⚖️ NeuralMind vs. Alternatives

Short answers to "why not just use X?". Each row links to a deeper page.

Full comparison index: docs/comparisons/.

---

Troubleshooting

"Connection closed" / "Connection failed" right after register. Almost always means an old NeuralMind install (≤ 0.4.x) where the MCP server was gated behind the [mcp] extra. From 0.5.0 onward the MCP SDK is bundled. Fix:

pip install --upgrade neuralmind

Then re-run the host's verify step (hermes mcp test neuralmind or openclaw mcp list).

neuralmind-mcp: command not found. The package installed but the console script wasn't put on PATH — usually because pip installed into a user site-packages dir that isn't on PATH. Add ~/.local/bin to PATH or reinstall in a venv where the entry point is on PATH.

The host shows neuralmind in mcp list but no tools when you query. Run neuralmind build /path/to/project first — the index has to exist before the MCP tools can answer queries. The hooks (SessionStart, UserPromptSubmit, PreCompact from neuralmind install-hooks) need a built index too.

❓ FAQ