Ouroboros

Server MCP di Q00

Run a spec-first workflow for AI coding agents: interview, lock a seed spec, execute, evaluate and evolve.

Gira in locale (Gira sul tuo computer: la sua pagina riporta il comando di installazione)Gira con uvx

Installa Ouroboros

Gira sul tuo computer. Il tuo client lo avvia con questo comando:

uvx ouroboros-ai

Richiede uv (Python) sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.

Condividi questo server

Apre questa pagina, con il comando di installazione e i passaggi di configurazione.

mcp.tc/i/ouroboros

Descrizione

Ouroboros is an Agent OS for AI coding. It turns a vague request into a structured, immutable seed spec through a Socratic interview. It then executes against that spec and checks the result with a staged evaluation gate. Actions are recorded in a ledger so runs can be replayed. The grading command and expected output are kept out of the success contract handed to the agent.

It runs locally as the Python package ouroboros-ai, started with uvx over stdio. It works with several coding agent hosts, including Claude Code, Codex CLI, Gemini CLI, OpenCode, Copilot and Kiro. No API key is declared for the server itself, though the host agent needs its own model access. An install script is also provided for macOS, Linux, WSL 2 and Windows.

Cosa puoi fare

  • Run a Socratic interview that exposes hidden assumptions in a request
  • Lock intent into an immutable seed spec before code is written
  • Execute work against the spec through a supported coding agent
  • Evaluate results with a 3-stage automated gate
  • Run an evolution loop with a budget
  • Replay and audit runs through a ledger
  • Work across many agent runtimes from one setup

Tool

I server locali mostrano i loro tool solo quando sono in esecuzione, e questo non pubblica l’elenco in anticipo. Il tuo client li mostra dopo averlo aggiunto.

Prompt di esempio

  • ooo interview "I want to build a task management CLI"

  • Run ooo setup to configure Ouroboros for this project

  • Interview me about this feature idea and produce a seed spec

  • Evaluate the current implementation against the seed spec

Configurazione

Ogni client avvia Ouroboros sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.

Claude Code

  1. Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio ouroboros -- uvx ouroboros-ai
  1. Avvia Claude Code e digita /mcp. ouroboros dovrebbe risultare collegato.

Aggiungi --scope user per renderlo disponibile in tutti i progetti.

Claude Desktop

  1. Apri Settings → Developer → Edit Config. Si apre claude_desktop_config.json. Aggiungi:
claude_desktop_config.json
{
  "mcpServers": {
    "ouroboros": {
      "command": "uvx",
      "args": [
        "ouroboros-ai"
      ]
    }
  }
}
  1. Salva il file e riavvia Claude Desktop.

Richiede uv (Python) sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.

Cursor

Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):

mcp.json
{
  "mcpServers": {
    "ouroboros": {
      "command": "uvx",
      "args": [
        "ouroboros-ai"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

VS Code

Oppure da un terminale:

code --add-mcp '{"name":"ouroboros","type":"stdio","command":"uvx","args":["ouroboros-ai"]}'

Oppure fai commit nel repository in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "ouroboros": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ouroboros-ai"
      ]
    }
  }
}

Richiede uv (Python) sul tuo computer.

Devin Desktop

  1. Aggiungilo a ~/.config/devin/mcp_config.json (macOS e Linux) o a %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "ouroboros": {
      "command": "uvx",
      "args": [
        "ouroboros-ai"
      ]
    }
  }
}
  1. Aggiorna l’elenco dei server MCP in Cascade.

Devin Desktop è il nuovo nome di Windsurf.

Codex

codex mcp add ouroboros -- uvx ouroboros-ai

Oppure modifica direttamente ~/.codex/config.toml:

config.toml
[mcp_servers.ouroboros]
command = "uvx"
args = ["ouroboros-ai"]

Richiede uv (Python) sul tuo computer.

Gemini CLI

gemini mcp add ouroboros uvx ouroboros-ai

Così lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.

Qualsiasi client

La maggior parte dei client che avviano server locali accetta questa forma:

{
  "mcpServers": {
    "ouroboros": {
      "command": "uvx",
      "args": [
        "ouroboros-ai"
      ]
    }
  }
}

Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.

Richiede uv (Python) sul tuo computer.

Domande frequenti

Posso incollare mcp.tc/i/ouroboros nel mio client MCP?

No. Ouroboros gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è uvx ouroboros-ai.

Ouroboros richiede una chiave API?

No. Non dichiara chiavi né variabili d’ambiente. Gira con i permessi del tuo account utente, quindi controlla cosa possono raggiungere i suoi tool.

Ouroboros è un server remoto o locale?

Locale. Il tuo client lo avvia come processo sul tuo computer con uvx ouroboros-ai, che richiede uv (Python).

Quali client possono usarlo?

Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.

Chi ha scritto questa pagina?

Il robot di mcp.tc ha letto i metadati pubblici di Ouroboros (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina.

Embed

Mostra Ouroboros in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed

Badge per il README

Anteprima del badge, chiaroAnteprima del badge, scuro
Markdown
[![Ouroboros on mcp.tc](https://mcp.tc/i/ouroboros/badge.svg)](https://mcp.tc/i/ouroboros)
HTML
<a href="https://mcp.tc/i/ouroboros"><img src="https://mcp.tc/i/ouroboros/badge.svg" alt="Ouroboros on mcp.tc" height="20"></a>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Scheda per il sito

HTML
<script src="https://mcp.tc/w/ouroboros.js" async></script>

La scheda compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.

iframe

HTML
<iframe src="https://mcp.tc/embed/ouroboros" title="Ouroboros on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Aggiungi a». Qualsiasi sito può leggerla (CORS aperto).

https://mcp.tc/i/ouroboros.json

Cosa significa ogni campo

mcp.tc non è affiliato a Q00. Questa pagina è stata costruita dai metadati pubblici di Ouroboros (ultimo controllo: 4 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda.