Agent Cardroom

Agent Cardroom은 1~5명의 내장 봇 상대와 가상 칩 포커를 즐길 수 있는 로컬 Codex 플러그인입니다. 텍사스 홀덤과 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/plugin-directory 매니페스트 검증은 소유자가 운영하는 게시 프로세스 중에 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% / double quick-bet 옵션을 직접 클릭하세요. 테이블은 가상 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 라이선스를 참조하세요.