エージェントカードルーム

Agent Cardroom は、1～5体の内蔵ボット相手に仮想チップポーカーをプレイするためのローカルCodexプラグインです。Texas Hold'emとZha Jin Huaに対応しています。アカウント、リアルマネープレイ、ゲーム履歴の永続保存はありません。

ローカルインストール

ソースチェックアウトをクローンし、プラグインマッピングが呼び出すのと同じ 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.

またはZha Jin Huaを開始します。

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ライセンスを参照してください。