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

模块检查特意放在安装之后。使用仓库本地市场清单 .agents/plugins/marketplace.json 从该仓库在 Codex 中安装插件，或安装 plugins/agent-cardroom/ 中的包。两个映射都运行 python3 -m agent_cardroom.mcp_stdio，因此它们不依赖于 Codex 的 PATH 上的虚拟环境目录。

对于开发和完整测试套件，创建一个隔离环境：

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/插件目录清单验证在所有者操作发布过程中在 Codex 环境中执行；它不是与 GitHub 无关的仓库命令。

对于托管适配器，会话在空闲 60 分钟后过期。要移除本地状态，停止适配器并重新启动；游戏不会永久保存。

游戏

要求插件开始一局游戏，例如：

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

在支持 MCP Apps UI 的 Agent 中，插件会在这次开场调用后，在当前对话中显示一个交互式牌桌。直接点击合法操作和 25% / 33% / 75% / 133% / 加倍快速下注选项；牌桌仅显示虚拟 Token 余额、当前底池、牌桌赌注和服务器批准的牌。它不使用真实钱包、存款或取款。

如果 UI 不可用，则从返回的状态中以文本形式操作：

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 设置为您的部署主机名的逗号分隔列表。agent-cardroom.onrender.com 上的 Render 服务作为初始部署主机名包含在内；在将公开列表切换到自定义域名之前，请先添加一个自定义域名。

请参阅隐私、服务条款和MIT 许可证。