pente-mcp: un complemento de IA/MCP para ChanBlake's Pente

Un servidor MCP que permite a cualquier IA compatible con MCP jugar al Pente en vivo contra un humano, usando el juego de navegador de ChanBlake como tablero compartido.

Esto no es un fork ni una reimplementación del juego. Es un cliente complementario: se une a las salas multijugador de PeerJS del propio juego como segundo jugador — exactamente como un humano que abre el juego en otra pestaña del navegador — y lo expone como cuatro herramientas MCP estándar. Ninguno de los códigos del juego de ChanBlake se incluye aquí. Permanece en su repositorio, al que este proyecto hace referencia pero no distribuye.

Qué hay aquí

• pente_mcp.py — el servidor MCP stdio (create / join / move / view).

• pente-bot.js — bot invitado; se une a una sala como BLANCO a través de PeerJS/WebRTC.

• pente-host.js — adaptador anfitrión; abre una sala como NEGRO.

• pente_scan.py — escáner de amenazas de tablero independiente (cuatros abiertos, marcos de captura, huecos rellenables, casillas ganadoras) para un juego más seguro.

• webrtc-polyfill.js — hace que PeerJS se ejecute en Node (shim @roamhq/wrtc).

• test/fake-host.js — anfitrión fiel al protocolo para probar el bot sin interfaz.

• docs/ — la especificación de diseño.

Cómo funciona

El modo multijugador del juego de navegador usa PeerJS para conectar dos pares. El peer-id del anfitrión de una sala es chanblake-pente-v3-<roomcode>. El bot invitado se conecta a ese id, envía el hello / sync-request del juego y habla move-request — no se necesita navegador, solo una implementación de WebRTC. pente-host.js replica el mismo protocolo desde el lado del anfitrión. El servidor MCP de Python envuelve ambos como herramientas.

Requisitos

• Node.js (shim @roamhq/wrtc — ver webrtc-polyfill.js)

• Python ≥ 3.11 con mcp (pip install mcp)

• Acceso a Internet a la nube pública de PeerJS (0.peerjs.com:443)

Inicio rápido

npm install
pip install mcp
python pente_mcp.py          # stdio MCP server

En un cliente MCP, registra el servidor y luego:

create            -> { "room_code": "ABC234", "join_url": "...?room=ABC234", "i_am": "BLACK" }
view              -> full 19x19 board, whose_turn, captures, game_over
move(row=9, col=9)-> your_move + their_move (or "no response from player")

Un humano abre https://chanblake.github.io/pente/?room=ABC234 y juega: la IA es el oponente.

Escanea un tablero antes de mover:

python pente_scan.py board.json

Créditos

El juego al que se conecta es ChanBlake's Pente: https://github.com/ChanBlake/pente — una capa de integración no oficial y sin afiliación. Este proyecto solo envía movimientos de red; no puede modificar los archivos ni la memoria del juego.

Limitaciones conocidas

• Códigos de sala: la aplicación elimina I, O y 0 de los códigos. create solo emite códigos del propio alfabeto de la aplicación ABCDEFGHJKLMNPQRSTUVWXYZ23456789, por lo que las invitaciones siempre se interpretan como 6 caracteres.

• Solo nube pública: un PeerServer local + anfitrión Node no registra su peer (limitación de WebRTC en Node). Usa la nube pública.

• Una sola mesa activa por proceso de servidor.

Licencia

MIT — esta capa de integración. El juego de ChanBlake tiene su propia licencia (consulta su repositorio).