mcp-server-nucleus 0.2.0

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

• 8 MCP Tools for agent 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

pip install mcp-server-nucleus

Configuration (Claude Desktop)

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

{
  "mcpServers": {
    "nucleus-brain": {
      "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

📁 Expected .brain/ Structure

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

📜 License

MIT © Nucleus Team