@rotifer/mcp-server

Self-evolving AI Agent framework — search, compare, and install Genes ranked by Arena fitness via MCP

GitHub

@rotifer/mcp-server

npm License: Apache-2.0 Node.js MCP

Search, inspect, compare, and rank AI Genes — directly from your IDE.

MCP server for the Rotifer Protocol Gene ecosystem. Works with Cursor, Claude Desktop, Windsurf, and any MCP-compatible client.

Quick Start

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["-y", "@rotifer/mcp-server"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "rotifer": {
      "command": "npx",
      "args": ["-y", "@rotifer/mcp-server"]
    }
  }
}

Windsurf / Other MCP Clients

Use the same npx command — any client that supports MCP stdio transport will work.

What Can It Do?

You: "Find the best gene for web search"
AI:  → search_genes({ query: "web search" })
     Found 8 genes. Top match: genesis-web-search (F(g) = 0.87, Native)

You: "Compare genesis-web-search vs genesis-web-search-lite"
AI:  → compare_genes({ gene_ids: ["...", "..."] })
     Side-by-side: success rate, latency, fitness breakdown

You: "What genes are installed locally?"
AI:  → list_local_genes()
     Found 5 genes in ./genes/

Tools

ToolDescription
search_genesSearch the Gene ecosystem by name, domain, or description
get_gene_detailGet detailed info about a specific Gene (phenotype, fitness, metadata)
get_arena_rankingsGet Arena rankings for a domain, sorted by F(g) fitness score
compare_genesSide-by-side fitness comparison of 2–5 Genes
get_gene_statsDownload statistics for a Gene (total, 7d, 30d, 90d)
get_leaderboardDeveloper reputation leaderboard
get_developer_profileDeveloper public profile and reputation data
list_local_genesScan local workspace for installed Genes

Resources

MCP Resources let AI clients reference Rotifer data as context:

URI TemplateDescription
rotifer://genes/{gene_id}/statsGene download statistics
rotifer://genes/{gene_id}Gene detail + phenotype
rotifer://developers/{username}Developer profile + reputation
rotifer://leaderboardTop developers by reputation score
rotifer://local/genesLocal Gene inventory

Architecture

┌─────────────────────────────────────────────────┐
│  AI IDE (Cursor / Claude / Windsurf)            │
│                                                 │
│  "Find genes for code formatting"               │
│       │                                         │
│       ▼                                         │
│  ┌─────────────────────┐                        │
│  │  MCP Client         │                        │
│  │  (stdio transport)  │                        │
│  └────────┬────────────┘                        │
└───────────┼─────────────────────────────────────┘
            │ MCP Protocol
            ▼
┌─────────────────────────────────────────────────┐
│  @rotifer/mcp-server                            │
│                                                 │
│  Tools      Resources      Local Scanner        │
│  ┌──────┐   ┌──────────┐   ┌───────────────┐   │
│  │search│   │gene://id │   │ ./genes/*.json │   │
│  │arena │   │dev://user│   │ phenotype scan │   │
│  │stats │   │leaderbd  │   └───────────────┘   │
│  └──┬───┘   └────┬─────┘                       │
└─────┼────────────┼──────────────────────────────┘
      │            │
      ▼            ▼
┌─────────────────────────────────────────────────┐
│  Rotifer Cloud API (Supabase)                   │
│  genes · arena_entries · developer_reputation   │
└─────────────────────────────────────────────────┘

Configuration

Zero-config by default — connects to the public Rotifer Cloud API.

To use a custom endpoint, create ~/.rotifer/cloud.json:

{
  "endpoint": "https://your-supabase-instance.supabase.co",
  "anonKey": "your-anon-key"
}

Or set environment variables:

ROTIFER_CLOUD_ENDPOINT=https://your-instance.supabase.co
ROTIFER_CLOUD_ANON_KEY=your-anon-key

Requirements

  • Node.js >= 20

Links

License

Apache-2.0

Related Servers