Ouroboros MCP Server

by q00io.github.Q00/ouroborosv0.51.5

Local agent OS for spec-first AI coding: a replayable, ledger-recorded interview, seed, execute, evaluate and evolve loop that MCP clients can drive.

6.2kPythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Ouroboros MCP server

claude mcp add ouroboros-ai -- uvx ouroboros-ai mcp serve --runtime claude-cli

{
  "mcpServers": {
    "ouroboros-ai": {
      "command": "uvx",
      "args": [
        "ouroboros-ai",
        "mcp",
        "serve",
        "--runtime",
        "claude-cli"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ouroboros-ai": {
      "command": "uvx",
      "args": [
        "ouroboros-ai",
        "mcp",
        "serve",
        "--runtime",
        "claude-cli"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ouroboros-ai": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ouroboros-ai",
        "mcp",
        "serve",
        "--runtime",
        "claude-cli"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ouroboros-ai": {
      "command": "uvx",
      "args": [
        "ouroboros-ai",
        "mcp",
        "serve",
        "--runtime",
        "claude-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
2026-10-06 · 2d ago · GitHub · v0.55.6
Package published
no data · npm/PyPI
Registry entry updated
2026-08-14 · 56d ago · official registry · v0.51.5

FAQ

›How do I install the Ouroboros MCP server in Claude Code?

Run: claude mcp add ouroboros-ai -- uvx ouroboros-ai mcp serve --runtime claude-cli. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ouroboros require an API key?

No required environment variables are declared in its published metadata.

›Can I use Ouroboros as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Ouroboros in the official MCP registry?

Yes, as io.github.Q00/ouroboros.