Agent Cardroom

Agent Cardroom ist ein lokales Codex-Plugin für Poker mit virtuellen Chips gegen 1–5 eingebaute Bot-Gegner. Es unterstützt Texas Hold'em und Zha Jin Hua. Es hat keine Konten, kein Echtgeldspiel und keine dauerhafte Spielhistorie.

Lokale Installation

Klonen Sie das Quell-Repository und installieren Sie dann das Paket für den aktuellen Benutzer mit demselben python3-Programm, das die Plugin-Zuordnung aufruft:

git clone https://github.com/GZ-L/agent-cardroom.git
cd agent-cardroom
python3 -m pip install --user .
python3 -m agent_cardroom.mcp_stdio --help

Die Modulprüfung erfolgt absichtlich nach der Installation. Installieren Sie das Plugin aus diesem Repository in Codex mit dem lokalen Marktplatz-Manifest unter .agents/plugins/marketplace.json oder installieren Sie das Bundle unter plugins/agent-cardroom/. Beide Zuordnungen führen python3 -m agent_cardroom.mcp_stdio aus, sodass sie nicht von einem virtuellen Umgebungsverzeichnis abhängen, das sich in Codex' PATH befindet.

Für die Entwicklung und die vollständige Testsuite erstellen Sie eine isolierte Umgebung:

python3 -m venv .venv
.venv/bin/python -m pip install -e ".[dev]"

Related MCP server: Nash-Arena

Überprüfung und lokale Adapter

Die folgenden Befehle verwenden die installierte virtuelle Umgebung dieses Repositorys. Führen Sie den HTTP-Befehl nur aus, wenn Sie den lokalen Adapter bereitstellen möchten; er läuft weiter, bis er unterbrochen wird.

.venv/bin/python -m pytest tests/test_acceptance.py -v
.venv/bin/python -m pytest -v
.venv/bin/ruff check src tests
git diff --check
.venv/bin/agent-cardroom-http --host 127.0.0.1 --port 8000

Dies sind die portablen Prüfungen des Projekts. Die Validierung des Codex/Plugin-Verzeichnis-Manifests wird in einer Codex-Umgebung während des vom Eigentümer betriebenen Veröffentlichungsprozesses durchgeführt; es handelt sich nicht um einen GitHub-agnostischen Checkout-Befehl.

Bei einem gehosteten Adapter verfallen Sitzungen nach 60 Minuten Inaktivität. Um den lokalen Zustand zu entfernen, stoppen Sie den Adapter und starten Sie ihn neu; Spiele werden nicht dauerhaft gespeichert.

Spielen

Bitten Sie das Plugin, ein Spiel zu starten, zum Beispiel:

Start a Texas Hold'em game with 3 bot opponents and 1,000 virtual chips.

In einem Agent, der die MCP Apps UI unterstützt, zeigt das Plugin nach diesem Aufruf einen interaktiven Tisch in der aktuellen Unterhaltung an. Klicken Sie direkt auf die legalen Aktionen und die Schnell-Einsatz-Optionen 25 % / 33 % / 75 % / 133 % / doppelt; der Tisch zeigt nur virtuelle Token-Guthaben, den aktuellen Pot, die Tischlimits und servergenehmigte Karten. Es verwendet keine echte Geldbörse, Einzahlungen oder Auszahlungen.

Falls die UI nicht verfügbar ist, handeln Sie basierend auf dem zurückgegebenen Zustand im Text:

Call in my Hold'em game.

Oder starten Sie Zha Jin Hua:

Start a Zha Jin Hua game with 2 bot opponents and 500 virtual chips.

Dieses Projekt dient nur der Unterhaltung mit virtuellen Chips und virtuellen Token. Verwenden Sie es nicht für Echtgeld-Glücksspiele.

Öffentliche Einreichung

Die Veröffentlichung im öffentlichen Verzeichnis ist ein manueller, identitätsgebundener, vom Eigentümer betriebener Prozess, der von der lokalen Installation getrennt ist. Der autorisierte Eigentümer muss ein öffentliches Repository erstellen und pushen, einen stabilen HTTPS MCP-Endpunkt hosten, die Domain-Verifizierung abschließen und über das Codex-Verzeichnisportal einreichen. Tests laden keinen Code hoch, erstellen keine GitHub-Repositorys, ändern keine DNS-Einträge und reichen nichts im OpenAI-Portal ein. Die lokale .mcp.json-Zuordnung dient nur für die GitHub-Download-Installation; sie wird nicht als öffentliches Einreichungsartefakt akzeptiert. Siehe die Einreichungs-Checkliste. Die Quell-Website, der Support-Tracker, die Datenschutzrichtlinie und die Nutzungsbedingungen sind in diesem Repository gehostet: Website, Support, Datenschutz und Nutzungsbedingungen.

Für eine öffentliche Bereitstellung setzen Sie MCP_ALLOWED_HOSTS auf eine durch Kommas getrennte Liste Ihrer Bereitstellungs-Hostnamen. Der Render-Dienst unter agent-cardroom.onrender.com ist als anfänglicher Bereitstellungs-Hostname enthalten; fügen Sie eine benutzerdefinierte Domain hinzu, bevor Sie die öffentliche Auflistung darauf umstellen.

Siehe Datenschutz, Nutzungsbedingungen und MIT-Lizenz.