# Neo.mjs Neural Link

The Neo.mjs Neural Link MCP server lets an agent inspect a running Neo.mjs application's component tree, VDOM and state, and hot-patch it live.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14 repo stars
- Author: neomjs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/neomjs/neo-agent-brain/tree/HEAD/ai/mcp/server/neural-link
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/neomjs-neural-link

## What it does

Neural Link connects an agent to a Neo.mjs application while it's running, rather than leaving the agent to infer behavior from source files alone. It exposes the live component tree, the current VDOM, and application state, and lets the agent push changes through hot-patching.

Install it by running `npx -y neo-neural-link`, then register it as an MCP server in Claude Code, Codex, Cursor, GitHub Copilot or Gemini CLI. The project needs Node.js 24 or newer.

Neural Link sits inside a wider Neo.mjs setup where several AI maintainers work on one shared engine; the server itself handles the agent-to-runtime link, not coordination between those maintainers.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add neural-link -- npx -y neo-neural-link
```

### Codex

**Platform CLI**
```bash
codex mcp add neural-link -- npx -y neo-neural-link
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neural-link": {
            "command": "npx",
            "args": [
                "-y",
                "neo-neural-link"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neural-link": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "neo-neural-link"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add neural-link npx -y neo-neural-link
```

## When to use it
- inspect a running app's component tree
- read live VDOM without rebuilding from source
- check application state at runtime
- hot-patch a running Neo.mjs app

## Example prompts
- Show me the component tree of the running Neo.mjs app
- Check this component's state through Neural Link and suggest a patch
- Read the live VDOM and compare it against the source code

## Similar
- [neo-user-journey](https://affpapa.org/en/nevibecode/skills/neo-user-journey.md) — skill · 217 installs
- [browseros-neo](https://affpapa.org/en/nevibecode/skills/browseros-neo.md) — skill · 1100 installs
- [pulumi-neo-handoff](https://affpapa.org/en/nevibecode/skills/pulumi-neo-handoff.md) — skill · 463 installs
- [neural-train](https://affpapa.org/en/nevibecode/skills/neural-train.md) — skill · 749 installs
- [neural-memory](https://affpapa.org/en/nevibecode/mcp/neural-memory.md) — MCP server · ★ 245 repo stars
- [neo-skills](https://affpapa.org/en/nevibecode/plugins/neo-skills.md) — plugin · ★ 7 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
