Agent Cardroom

Agent Cardroom — это локальный плагин для Codex, предназначенный для игры в покер на виртуальные фишки против 1–5 встроенных ботов. Поддерживаются Техасский Холдем и Чжа Цзинь Хуа. В нём нет учётных записей, игры на реальные деньги или постоянной истории игр.

Локальная установка

Клонируйте исходный репозиторий, затем установите пакет для текущего пользователя с помощью того же исполняемого файла python3, который используется в маппинге плагина:

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

Проверка модуля намеренно выполняется после установки. Установите плагин из этого репозитория в Codex, используя манифест локального маркетплейса по адресу .agents/plugins/marketplace.json, или установите пакет из plugins/agent-cardroom/. Оба маппинга запускают python3 -m agent_cardroom.mcp_stdio, поэтому они не зависят от того, что каталог виртуального окружения находится в PATH Codex.

Для разработки и полного набора тестов создайте изолированное окружение:

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

Related MCP server: Nash-Arena

Проверка и локальные адаптеры

Следующие команды используют установленное виртуальное окружение этого репозитория. Запускайте HTTP-команду только тогда, когда хотите запустить локальный адаптер; она будет работать до прерывания.

.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

Это портативные проверки проекта. Валидация манифеста Codex/plugin-directory выполняется в среде Codex в процессе публикации, управляемом владельцем; это не команда проверки, не зависящая от GitHub.

Для размещённого адаптера сессии истекают через 60 минут бездействия. Чтобы удалить локальное состояние, остановите адаптер и запустите его снова; игры не сохраняются постоянно.

Игра

Попросите плагин начать игру, например:

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

В агенте, поддерживающем интерфейс MCP Apps, плагин после этого вызова показывает интерактивный стол в текущем разговоре. Нажимайте на разрешённые действия и кнопки быстрых ставок 25% / 33% / 75% / 133% / удвоение напрямую; на столе отображаются только виртуальные балансы Token, текущий банк, ставки стола и одобренные сервером карты. Он не использует реальный кошелёк, депозиты или вывод средств.

Если интерфейс недоступен, действуйте на основе возвращённого состояния в текстовом виде:

Call in my Hold'em game.

Или начните Чжа Цзинь Хуа:

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

Этот проект предназначен только для развлечения с виртуальными фишками и виртуальными Token. Не используйте его для азартных игр на реальные деньги.

Публичная подача

Публикация в общедоступном каталоге — это ручной процесс, привязанный к личности и управляемый владельцем, отдельный от локальной установки. Уполномоченный владелец должен создать и опубликовать публичный репозиторий, разместить стабильную HTTPS-конечную точку MCP, завершить проверку домена и отправить заявку через портал каталога Codex. Тесты не загружают код, не создают репозитории GitHub, не изменяют DNS и не отправляют заявки на портал OpenAI. Локальный маппинг .mcp.json предназначен только для установки через загрузку с GitHub; он не принимается как артефакт публичной подачи. См. контрольный список подачи. Исходный сайт, трекер поддержки, политика конфиденциальности и условия размещены в этом репозитории: сайт, поддержка, конфиденциальность и условия.

Для публичного развёртывания установите MCP_ALLOWED_HOSTS в виде списка имён хостов вашего развёртывания, разделённых запятыми. Сервис Render по адресу agent-cardroom.onrender.com включён как начальное имя хоста развёртывания; добавьте собственный домен перед переключением публичного списка на него.

См. Конфиденциальность, Условия и Лицензия MIT.