Skip to content
NeuroDock

Installation

The one-liner

Section titled “The one-liner”
Terminal window
npx --yes @neurodock/cli@latest install-all

30-second TL;DR

Section titled “30-second TL;DR”

That one command installs the five NeuroDock MCP servers from PyPI (via uvx), detects which MCP-aware clients you have (Claude Desktop, Claude Code, Cursor), and writes the server registration block into each of their config files. Then you restart your client and the tools appear.

This is the developer preview (@neurodock/cli v0.5.0). The substrate is at v0.2.1 and all five MCP servers are live on PyPI.

Per-client configuration

Section titled “Per-client configuration”

The installer writes these snippets for you. They are shown here so you can verify what landed, or hand-edit if you skipped install-all.

Every MCP-aware client uses the same mcpServers block; the only thing that varies is where the config file lives.

Claude

Claude Desktop reads claude_desktop_config.json:

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

After install-all, you should see:

{
  "mcpServers": {
    "neurodock-chronometric": { "command": "uvx", "args": ["neurodock-mcp-chronometric"] },
    "neurodock-cognitive-graph": { "command": "uvx", "args": ["neurodock-mcp-cognitive-graph"] },
    "neurodock-task-fractionator": { "command": "uvx", "args": ["neurodock-mcp-task-fractionator"] },
    "neurodock-translation": { "command": "uvx", "args": ["neurodock-mcp-translation"] },
    "neurodock-guardrail": { "command": "uvx", "args": ["neurodock-mcp-guardrail"] }
  }
}

Restart Claude Desktop after install (full quit — see callout above).

Verify the install

Section titled “Verify the install”
Terminal window
neurodock doctor

doctor checks: profile is readable and schema-valid, all five MCP servers start, embedding backend is reachable. Failures are explained with the next action to take.

Prerequisites

Section titled “Prerequisites”
  • Node.js 22 or newer. Check with node --version.
  • Python 3.11 or newer. Check with python --version.
  • uv for Python workspace management. Install from astral.sh/uv. uvx is the per-tool launcher that ships with uv.
  • An MCP-aware client. Claude Desktop, Claude Code, or Cursor. The substrate is vendor-neutral; any client that speaks MCP works.

Optional but recommended for local-first embeddings:

  • Ollama with the nomic-embed-text-v1.5 model pulled. The cognitive graph falls back to fastembed-py if Ollama is unavailable.
Manual install (from a clone)

If you’d rather build from source, or you want to hack on the substrate:

Terminal window
git clone https://github.com/tlennon-ie/neurodock.git
cd neurodock
pnpm install
uv sync

Both workspaces install in parallel — Node packages via pnpm, Python packages via uv.

Then run the installer from the clone:

Terminal window
npx neurodock init

The installer:

  1. Detects your installed MCP clients.
  2. Writes a default profile to ~/.neurodock/profile.yaml (you will be prompted for display_name and neurotypes).
  3. Registers the five substrate MCP servers with each detected client.
  4. Prints a summary of what was changed.

Preview before writing

Section titled “Preview before writing”
Terminal window
npx neurodock init --dry-run

--dry-run prints every file that would be created or modified without touching anything. Useful for review, useful for CI.

What’s next

Section titled “What’s next”