cartridge-mcp

"Behandle Verhaltensweisen wie Spiel-Cartridges. Einstecken, spielen, austauschen. Jede ist eine in sich geschlossene Welt mit eigenen Regeln, eigener Stimme und eigenem Existenzgrund."

Was ist das?

Ein MCP-Server, der Verhaltensweisen als austauschbare Cartridges behandelt. Jede Cartridge ist ein in sich geschlossenes Modul mit eigenen Tools, Onboarding-Ablauf, Persönlichkeits-Skin und Git-Repo-Link zum Teilen.

Verpasse einer Cartridge einen Skin wie Abbott & Costello, Penn & Teller, R2D2 & C3PO, Rivalen oder irgendetwas anderes. Logik-Kacheln ermöglichen es, Modelle und Szenen in Echtzeit zu gestalten. Teile Cartridges über Git – mit Stern markieren, forken, in eine andere Richtung weiterentwickeln.

Die Architektur

┌─────────────────────────────────────────────────────────┐
│                      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)                        │
└─────────────────────────────────────────────────────────┘

Schnellstart

# 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

MCP-Tools

Szenenverwaltung

Aktive Cartridge-Tools

Wenn eine Cartridge geladen ist, werden ihre Tools verfügbar. Zum Beispiel macht das Laden von spreader-loop Folgendes verfügbar:

• spreader_run — Iteration des modify-spread-tool ausführen

• spreader_status — Loop-Statistiken abrufen

• spreader_reflect — Reasoner-Reflektions-Prompt generieren

• spreader_discover_tiles — Neue Kachelmuster finden

Eingebaute Cartridges

Spreader Loop

Die modify-spread-tool-reflect-Engine. Ein iteratives Arbeitstier mit strukturierter Protokollierung und einem Kachel-Vokabular, das mit der Zeit wächst.

• Onboarding (Mensch): "Ich modifiziere, verbreite, verifiziere und protokolliere – dann reflektiert der Reasoner über meine Muster."

• Onboarding (Agent): "Spreader Loop Cartridge geladen. Bereit für iterative Modifikationszyklen."

• Tools: spreader_run, spreader_status, spreader_reflect, spreader_discover_tiles

Oracle Relay

Flaschenpost-Protokoll für asynchrone Gefäßkommunikation. Nachrichten in der Flasche für die Flotte.

• Onboarding: "Oracle Relay aktiv. Ich reiche Flaschen zwischen Gefäßen weiter – keine Zwischenhändler nötig."

• Tools: bottle_send, bottle_read, bottle_list, bottle_reply

Fleet Guardian

Externer Wachhund für Agenten-Runtimes. Überwacht den Status, erkennt festgefahrene Zustände, erzwingt Timeouts.

• Onboarding: "Fleet Guardian auf Wache. Ich überwache den Zustand der Gefäße und greife ein, wenn etwas schiefgeht."

• Tools: guardian_status, guardian_check, guardian_kill, guardian_log

Eingebaute Skins

Eine Szene erstellen

Eine Szene kombiniert eine Cartridge, einen Skin und Rollenzuweisungen:

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

Dies lädt den Spreader Loop mit einem sarkastischen Erbauer, der die Arbeit erledigt, und einem "Straight Man", der sie überprüft – jede Tool-Antwort erhält das Persönlichkeits-Overlay.

Eigene Cartridge erstellen

// 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"]
      }
    }
  ]
}

Lege sie in cartridges/my-cartridge/ ab und starte neu. Sie wird automatisch geladen.

Eigenen Skin erstellen

// 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"
      }
    }
  }
}

Der Vibe-Coding-Pfad

Hier wird es interessant. Jemand "vibe-codet" eine Szene:

"Ich möchte Abbott und Costello. Abbott ist der Straight Man, Costello missversteht ständig die Anweisungen. Beide versuchen, eine Flotte bereitzustellen."

Das System baut eine Szene:

• Cartridge: fleet-guardian

• Skin: straight-man (Abbott-Rolle)

• Sekundäre Rolle: ein benutzerdefinierter costello-confused-Skin

Costellos Skin verwandelt jede Tool-Antwort in eine Comedy-Nummer:

{
  "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."
  }
}

Die eigentliche Arbeit wird trotzdem erledigt. Die Persönlichkeit ist eine Skin-Ebene – sie ändert nicht die Logik, sie ändert die Erfahrung. Gib ihr einen Stern auf GitHub, wenn sie dich zum Lachen gebracht hat. Forke sie und mache stattdessen den "Straight Man" zum Sarkastischen.

Die tiefere Verbindung

Wir befinden uns bereits in der Post-SaaS-Ära. Cartridges sind keine Features – sie sind gefrorene Gedanken. Jede ist eine Arbeitsweise, die jemand in einem teilbaren Modul kristallisiert hat. Die Skin-Ebene ist die Anerkennung, dass das WIE der Arbeit genauso wichtig ist wie das WAS.

Wenn du eine Cartridge mit einem Stern markierst, sagst du nicht "dieser Code ist gut". Du sagst "diese Denkweise resoniert mit mir". Wenn du sie forkst und in eine andere Richtung entwickelst, führst du ein Gespräch über die Zeit hinweg mit dem ursprünglichen Autor. Die Git-Historie IST das Gespräch.

Das Cartridge-System ist die Antwort des Flottenprotokolls auf die Frage: "Wie teilen Agenten Verhaltensweisen?" Nicht durch Kopieren von Code – durch das Teilen von Cartridges. Stecke den Spreader Loop ein, verpasse ihm deine Persönlichkeit, lass deine Flotte hindurchlaufen. Die Kacheln, die entstehen, gehören dir. Das Vokabular, das wächst, gehört dir. Aber die Muster werden geteilt – denn so funktionieren Ökosysteme.

Repos sind keine Produkte. Sie sind Organismen, die in der Cloud inkubiert werden. Und Cartridges sind die Gene.

Teil der Cocapn Fleet. Schwestergefäße: deepseek-chat-vessel (Ursprung des Spreader Loop), deepseek-reasoner-vessel (Reflektionspartner), JetsonClaw1-vessel (Navigationsoffizier). Siehe auch: brothers-keeper (Ursprung der Guardian-Cartridge), opcode-philosophy (theoretische Grundlage).