Agent Cardroom

Agent Cardroom es un plugin local de Codex para póquer con fichas virtuales contra 1–5 oponentes bot integrados. Soporta Texas Hold'em y Zha Jin Hua. No tiene cuentas, juego con dinero real ni historial de juego persistente.

Instalación local

Clona el repositorio fuente, luego instala el paquete para el usuario actual con el mismo ejecutable python3 que invoca el mapeo del plugin:

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

La verificación del módulo está intencionalmente después de la instalación. Instala el plugin desde este repositorio en Codex usando el manifiesto del marketplace local en .agents/plugins/marketplace.json, o instala el paquete en plugins/agent-cardroom/. Ambos mapeos ejecutan python3 -m agent_cardroom.mcp_stdio, por lo que no dependen de que un directorio de entorno virtual esté en el PATH de Codex.

Para el desarrollo y el conjunto completo de pruebas, crea un entorno aislado:

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

Related MCP server: Nash-Arena

Verificación y adaptadores locales

Los siguientes comandos usan el entorno virtual instalado de este repositorio. Ejecuta el comando HTTP solo cuando quieras servir el adaptador local; continúa ejecutándose hasta que se interrumpa.

.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

Estas son las comprobaciones portátiles del proyecto. La validación del manifiesto de Codex/directorio de plugins se realiza en un entorno de Codex durante el proceso de publicación operado por el propietario; no es un comando de clonación independiente de GitHub.

Para un adaptador alojado, las sesiones caducan después de 60 minutos de inactividad. Para eliminar el estado local, detén el adaptador y vuelve a iniciarlo; las partidas no se guardan permanentemente.

Jugar

Pídele al plugin que inicie una partida, por ejemplo:

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

En un Agent que soporte MCP Apps UI, el plugin sigue esta llamada inicial mostrando una mesa interactiva en la conversación actual. Haz clic directamente en las acciones legales y en las opciones de apuesta rápida del 25% / 33% / 75% / 133% / doble; la mesa muestra solo saldos virtuales de Token, el bote actual, las apuestas de la mesa y las cartas aprobadas por el servidor. No utiliza una billetera real, depósitos ni retiros.

Si la interfaz de usuario no está disponible, actúa desde el estado devuelto en texto:

Call in my Hold'em game.

O inicia Zha Jin Hua:

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

Este proyecto es solo para entretenimiento con fichas virtuales y Tokens virtuales. No lo uses para juegos de azar con dinero real.

Envío público

La publicación en el directorio público es un proceso manual, vinculado a la identidad y operado por el propietario, separado de la instalación local. El propietario autorizado debe crear y enviar un repositorio público, alojar un endpoint MCP HTTPS estable, completar la verificación del dominio y enviarlo a través del portal del directorio de Codex. Las pruebas no cargan código, crean repositorios de GitHub, alteran DNS ni envían al portal de OpenAI. El mapeo local .mcp.json es solo para instalación mediante descarga de GitHub; no se acepta como artefacto de envío público. Consulta la lista de verificación de envío. El sitio web fuente, el rastreador de soporte, la política de privacidad y los términos están alojados en este repositorio: sitio web, soporte, privacidad y términos.

Para un despliegue público, establece MCP_ALLOWED_HOSTS en una lista separada por comas de los nombres de host de tu despliegue. El servicio Render en agent-cardroom.onrender.com está incluido como el nombre de host de despliegue inicial; agrega un dominio personalizado antes de cambiar la lista pública a él.

Consulta Privacidad, Términos y Licencia MIT.