How to Install Nucleus MCP in Windsurf

Sovereign Agent OS — Persistent Memory & Governance for AI Agents

What Nucleus MCP does

Persistent memory and governance for AI coding agents. Local-first .brain/ directory with engrams, audit log, and hypervisor file protection. Optional remote sync to relay.nucleusos.dev. Works across Cursor, Claude Code, Windsurf, and Gemini via Streamable HTTP or stdio. Features: persistent memory, governance, local-first, multi-client, remote sync. Install: pip install nucleus-mcp && nucleus-init --scan

memory

ai-agents

windsurf

Installation steps

1Copy the config below
2Open ~/.codeium/windsurf/mcp_config.json
3Paste inside "mcpServers": {}
4Restart Windsurf

Configuration

File location: ~/.codeium/windsurf/mcp_config.json

mcp_config.jsonjson

{
  "nucleusMcp": {
    "command": "pip",
    "args": [
      "install",
      "nucleus-mcp",
      "&&",
      "nucleus-init",
      "--scan"
    ]
  }
}

Full server details GitHub Open Config Editor

Install in other clients

🤖Claude Desktop 💻Claude Code ⌨️Cursor ✨OpenAI ♊Gemini

For maintainers

If you maintain Nucleus MCP, add this badge to your README to show it's verified on CuratedMCP:

[![CuratedMCP Verified](https://www.curatedmcp.com/api/badge/nucleus-mcp)](https://www.curatedmcp.com/marketplace/nucleus-mcp)

Related servers

Memory MCP Server

Persistent memory for AI agents using a local knowledge graph — remember facts across sessions

Free