What is ouroboros?
ouroboros is a MCP server by Q00 that local agent OS for spec-first AI coding: a replayable, ledger-recorded interview, seed, execute, evaluate and evolve loop that MCP clients can drive. It is listed under Developer tools and has 6,239 GitHub stars.
| Type | Mcp server |
|---|---|
| Author | Q00 |
| Repository | Q00/ouroboros |
| Popularity | 6,239 GitHub stars |
| Category | Developer tools |
| Security | Review before installing (72/100) |
| Rank | #81 of 4,418 MCP servers; #50 in Developer tools |
| License | MIT |
| Last commit | 2026-10-17 |
| Stars this week | +37 |
| Runs | Locally |
| Language | Python |
| Platforms | macOS, Windows, Linux |
Is ouroboros safe to install?
ouroboros scores 72/100 on the MCPMods security check: Review before installing. Things to review: can take actions such as send, write or deploy; executes code or shell commands. It passed 3 of 6 checks.
MCP server results come from listing signals: who publishes it, where your data goes and what it can do. The code itself is not scanned yet.
| Check | Result |
|---|---|
| Community-built server | Note |
| Runs on your machine only | Pass |
| No credentials mentioned | Pass |
| Can take actions such as send, write or deploy | Review |
| Executes code or shell commands | Review |
| Source on GitHub | Pass |
How do I install ouroboros?
- Find the launch command. The README says how the server starts (npx, uvx, docker or a remote URL) and which API keys it needs.
https://github.com/Q00/ouroboros
- Add it to Claude Code. Replace the part after -- with the command from the README. Remote servers use --transport http with a URL.
claude mcp add ouroboros -- <command from README> claude mcp add --transport http ouroboros <server-url>
- Check it connected. This lists your MCP servers and their status.
claude mcp list
Or ask Claude to set it up
Paste this into Claude Code and it installs ouroboros for you:
Add the "ouroboros" MCP server from https://github.com/Q00/ouroboros to Claude Code. Read its README for the launch command and any API keys I need, run claude mcp add, then check that it connects.