z3rno-mcp

⚠️ Deprecated — full rewrite in progress

z3rno is being rewritten from the ground up as a single open-source Rust monorepo (Apache 2.0), following direct feedback from enterprise users that the current architecture is too complex.

• Maintenance mode only — bug fixes, no new features.
• Existing installs keep working. Nothing here is being yanked, archived, or removed.
• The new monorepo lands at the-ai-project-co/z3rno.
• Track progress: https://github.com/the-ai-project-co/z3rno-mcp/issues/3

MCP (Model Context Protocol) server that exposes Z3rno memory operations as tools. Gives any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, etc.) the ability to store, recall, forget, and audit agent memories.

Tools

Installation

# Zero-install run — same UX as npx for Python tools
uvx z3rno-mcp

# Pin into a project
uv pip install z3rno-mcp

# Or with pip
pip install z3rno-mcp

Claude Code plugin

A plugin manifest at claude-code-plugin/plugin.json pins uvx z3rno-mcp and declares all twelve tools. Point Claude Code at it and set Z3RNO_API_KEY before launch.

Configuration

Set environment variables:

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "z3rno": {
      "command": "z3rno-mcp",
      "env": {
        "Z3RNO_API_KEY": "z3rno_sk_...",
        "Z3RNO_AGENT_ID": "my-agent"
      }
    }
  }
}

If installed via uv, use the full path:

{
  "mcpServers": {
    "z3rno": {
      "command": "uv",
      "args": ["run", "z3rno-mcp"],
      "env": {
        "Z3RNO_API_KEY": "z3rno_sk_...",
        "Z3RNO_AGENT_ID": "my-agent"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "z3rno": {
      "command": "z3rno-mcp",
      "env": {
        "Z3RNO_API_KEY": "z3rno_sk_...",
        "Z3RNO_AGENT_ID": "my-agent"
      }
    }
  }
}

Claude Code

claude mcp add z3rno -- z3rno-mcp

Then set environment variables in your shell profile or .env.

For a detailed step-by-step setup, see QUICKSTART.md.

Full documentation: astron-bb4261fd.mintlify.app

Local Development

# Clone and install
git clone https://github.com/the-ai-project-co/z3rno-mcp.git
cd z3rno-mcp
uv sync --dev

# Run directly
Z3RNO_API_KEY=z3rno_sk_test Z3RNO_BASE_URL=http://localhost:8000 uv run z3rno-mcp

# Lint and format
uv run ruff check .
uv run ruff format .

License

Apache-2.0