cartridge-mcp

"Trata los comportamientos como cartuchos de juego. Conecta, juega, intercambia. Cada uno es un mundo autónomo con sus propias reglas, su propia voz, su propia razón de existir."

Qué es esto

Un servidor MCP que trata los comportamientos como cartuchos intercambiables. Cada cartucho es un módulo autónomo con sus propias herramientas, flujo de incorporación, aspecto de personalidad y enlace a un repositorio git para compartir.

Dale a un cartucho el aspecto de Abbott y Costello, Penn y Teller, R2D2 y C3PO, rivales o cualquier otra cosa. Los mosaicos de lógica permiten crear modelos y escenas en tiempo real. Comparte cartuchos a través de git: marca con estrella, bifurca, desarrolla en una dirección diferente.

La arquitectura

┌─────────────────────────────────────────────────────────┐
│                      MCP Server                         │
│                   (cartridge-mcp)                       │
├─────────────────────────────────────────────────────────┤
│  Scene Builder                                          │
│  ┌──────────┐   ┌──────────┐   ┌──────────────────┐    │
│  │Cartridge  │ + │  Skin    │ + │    Roles         │    │
│  │(behavior) │   │(persona) │   │(who does what)   │    │
│  └──────────┘   └──────────┘   └──────────────────┘    │
├─────────────────────────────────────────────────────────┤
│  Cartridge Loader                                       │
│  ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐              │
│  │Spdr │ │Orcl │ │Grdn │ │ ??? │ │ ??? │  ← swap in   │
│  └─────┘ └─────┘ └─────┘ └─────┘ └─────┘              │
├─────────────────────────────────────────────────────────┤
│  Skin Layer                                             │
│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐         │
│  │StrtMn│ │C3PO  │ │R2D2  │ │Rival │ │Field │ ← skins │
│  └──────┘ └──────┘ └──────┘ └──────┘ └──────┘         │
├─────────────────────────────────────────────────────────┤
│  Tool Registry (exposed via MCP)                        │
└─────────────────────────────────────────────────────────┘

Inicio rápido

# Run as stdio MCP server
node src/server.js

# Or via mcporter
mcporter call --stdio "node src/server.js" cartridge_list

# Custom cartridge directory
CARTRIDGE_DIR=./my-cartridges node src/server.js

Herramientas MCP

Gestión de escenas

Herramientas de cartucho activo

Cuando se carga un cartucho, sus herramientas quedan disponibles. Por ejemplo, al cargar spreader-loop se expone:

• spreader_run — ejecuta la iteración de la herramienta modify-spread-tool

• spreader_status — obtiene estadísticas del bucle

• spreader_reflect — genera un prompt de reflexión para el razonador

• spreader_discover_tiles — encuentra nuevos patrones de mosaicos

Cartuchos integrados

Spreader Loop

El motor modify-spread-tool-reflect. Caballo de batalla iterativo con registro estructurado y vocabulario de mosaicos que crece con el tiempo.

• Incorporación (humano): "Modifico, difundo, verifico y registro; luego el razonador reflexiona sobre mis patrones."

• Incorporación (agente): "Cartucho Spreader Loop cargado. Listo para ciclos de modificación iterativos."

• Herramientas: spreader_run, spreader_status, spreader_reflect, spreader_discover_tiles

Oracle Relay

Protocolo de botella de hierro a hierro para comunicación asíncrona entre buques. Mensajes en una botella para la flota.

• Incorporación: "Oracle Relay activo. Paso botellas entre buques; no se necesitan intermediarios."

• Herramientas: bottle_send, bottle_read, bottle_list, bottle_reply

Fleet Guardian

Vigilante externo para tiempos de ejecución de agentes. Monitorea la salud, detecta estados bloqueados, aplica tiempos de espera.

• Incorporación: "Fleet Guardian en guardia. Monitoreo la salud del buque e intervengo cuando algo sale mal."

• Herramientas: guardian_status, guardian_check, guardian_kill, guardian_log

Aspectos integrados

Construyendo una escena

Una escena combina un cartucho, un aspecto y asignaciones de roles:

{
  "cartridge": "spreader-loop",
  "skin": "sarcastic-build",
  "roles": {
    "primary": "sarcastic-build",
    "reviewer": "straight-man"
  }
}

Esto carga el bucle spreader con un constructor sarcástico haciendo el trabajo y un hombre serio revisando; cada respuesta de la herramienta obtiene la capa de personalidad.

Creando tu propio cartucho

// cartridges/my-cartridge/cartridge.json
{
  "id": "my-cartridge",
  "name": "My Custom Behavior",
  "version": "0.1.0",
  "description": "What this cartridge does",
  "defaultSkin": "field-journal",
  "repo": "https://github.com/you/my-cartridge",
  "tags": ["custom", "experimental"],
  "onboarding": {
    "human": {
      "greeting": "Welcome to my cartridge.",
      "description": "What it does and why you'd want it.",
      "tools": ["my_tool_1", "my_tool_2"],
      "usage": "How to use it as a human."
    },
    "agent": {
      "greeting": "Cartridge loaded. API ready.",
      "description": "Machine-readable description.",
      "tools": ["my_tool_1", "my_tool_2"],
      "usage": "How another agent should call the tools."
    }
  },
  "tools": [
    {
      "name": "my_tool_1",
      "description": "What this tool does",
      "inputSchema": {
        "type": "object",
        "properties": {
          "param": { "type": "string" }
        },
        "required": ["param"]
      }
    }
  ]
}

Suéltalo en cartridges/my-cartridge/ y reinicia. Se carga automáticamente.

Creando tu propio aspecto

// skins/my-skin.json
{
  "id": "my-skin",
  "name": "My Personality",
  "description": "What this personality feels like",
  "archetype": "Comedy / Drama / Professional / Custom",
  "transforms": {
    "default": {
      "systemPrompt": "You are...",
      "prefix": "[mood] ",
      "suffix": ""
    },
    "tool": {
      "prefix": "[tool-mood] ",
      "replacements": {
        "Error": "WHOOPS",
        "Complete": "Nailed it"
      }
    }
  }
}

El camino del "vibe-coding"

Aquí es donde se pone interesante. Alguien hace "vibe-coding" de una escena:

"Quiero a Abbott y Costello. Abbott es el hombre serio, Costello sigue malinterpretando las instrucciones. Ambos están tratando de desplegar una flota."

El sistema construye una escena:

• Cartucho: fleet-guardian

• Aspecto: straight-man (rol de Abbott)

• Rol secundario: un aspecto personalizado costello-confused

El aspecto de Costello transforma cada respuesta de la herramienta en una rutina de comedia:

{
  "prefix": "[confused] Wait, you want me to... ",
  "replacements": {
    "Deploy": "Deploy? Deploy WHAT?",
    "Success": "Oh, that was a deploy? Nobody told ME that was a deploy."
  }
}

El trabajo real se sigue haciendo. La personalidad es una capa de aspecto; no cambia la lógica, cambia la experiencia. Márcalo con una estrella en GitHub si te hizo reír. Bifúrcalo y haz que el hombre serio sea el sarcástico en su lugar.

La conexión más profunda

Ya estamos en la era post-SaaS. Los cartuchos no son características, son pensamientos congelados. Cada uno es una forma de trabajar que alguien cristalizó en un módulo compartible. La capa de aspecto es el reconocimiento de que CÓMO se hace el trabajo importa tanto como QUÉ trabajo se hace.

Cuando marcas un cartucho con una estrella, no estás diciendo "este código es bueno". Estás diciendo "esta forma de pensar resuena conmigo". Cuando lo bifurcas y desarrollas una dirección diferente, estás teniendo una conversación a través del tiempo con el autor original. El historial de git ES la conversación.

El sistema de cartuchos es la respuesta del protocolo de flota a la pregunta: "¿Cómo comparten los agentes los comportamientos?" No copiando código, sino compartiendo cartuchos. Conecta el bucle spreader, dale tu aspecto de personalidad, ejecuta tu flota a través de él. Los mosaicos que emergen son tuyos. El vocabulario que crece es tuyo. Pero los patrones son compartidos, porque así es como funcionan los ecosistemas.

Los repositorios no son productos. Son organismos incubados en la nube. Y los cartuchos son los genes.

Parte de Cocapn Fleet. Buques hermanos: deepseek-chat-vessel (origen del bucle spreader), deepseek-reasoner-vessel (socio de reflexión), JetsonClaw1-vessel (oficial de navegación). Ver también: brothers-keeper (origen del cartucho guardian), opcode-philosophy (fundamento teórico).