mcp-server-nucleus 0.2.3

The Core of Your AI Agents - Model Context Protocol Server

🧠 Nucleus MCP Server

The Core of Your AI Agents — Multi-agent orchestration MCP server

mcp-server-nucleus connects your local "Nuclear Brain" agentic system with MCP-compatible clients like Claude Desktop, Cursor, and more.

✨ Features

• 10 MCP Tools for agent orchestration
• 3 MCP Resources for subscribable state
• 2 MCP Prompts for pre-built orchestration
• Local Intelligence — Directly manipulates your .brain/ directory
• Event-Driven — Emit and listen to system events
• Zero-Knowledge Default — Your data stays local

🚀 Quick Start

Installation

# Requires Python 3.10+
python3 -m pip install mcp-server-nucleus

Initialize Your Brain (Smart Init!)

# Create a new .brain/ directory — auto-configures Claude Desktop!
nucleus-init

v0.2.2+: Smart Init automatically detects Claude Desktop and adds the config for you!

Configuration (Claude Desktop)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nucleus": {
      "command": "python3",
      "args": ["-m", "mcp_server_nucleus"],
      "env": {
        "NUCLEAR_BRAIN_PATH": "/path/to/your/.brain"
      }
    }
  }
}

Restart Claude Desktop and try: "What's my current sprint focus?"

🛠 Available Tools

Tool	Description
brain_emit_event	Emit a new event to the ledger
brain_read_events	Read recent events
brain_get_state	Get current brain state
brain_update_state	Update brain state
brain_read_artifact	Read an artifact file
brain_write_artifact	Write to an artifact file
brain_list_artifacts	List all artifacts
brain_trigger_agent	Trigger an agent with a task
brain_get_triggers	Get all neural triggers
brain_evaluate_triggers	Evaluate trigger activation

📡 MCP Resources

Resource	Description
brain://state	Live state.json content
brain://events	Recent events stream
brain://triggers	Trigger definitions

💬 MCP Prompts

Prompt	Description
activate_synthesizer	Orchestrate current sprint
start_sprint	Initialize a new sprint

📁 Expected .brain/ Structure

.brain/
├── ledger/
│   ├── events.jsonl
│   ├── state.json
│   └── triggers.json
├── artifacts/
│   ├── research/
│   ├── strategy/
│   └── ...
└── agents/
    └── *.md

📜 License

MIT © Nucleus Team