pente-mcp — ein KI/MCP-Add-on für ChanBlake's Pente

Ein MCP-Server, der es jeder MCP-fähigen KI ermöglicht, live gegen einen Menschen Pente zu spielen, wobei ChanBlake's Browser-Spiel als gemeinsames Spielfeld dient.

Dies ist kein Fork und keine Neuimplementierung des Spiels. Es ist ein Add-on-Client: Er tritt den PeerJS-Mehrspielerräumen des Spiels als zweiter Spieler bei — genau wie ein Mensch, der das Spiel in einem anderen Browser-Tab öffnet — und stellt das als vier standardmäßige MCP-Tools bereit. Keinerlei Code aus ChanBlake's Spiel ist hier enthalten. Er bleibt in seinem Repository, auf das dieses Projekt verweist, ohne es auszuliefern.

Was hier enthalten ist

• pente_mcp.py — der stdio-MCP-Server (create / join / move / view).

• pente-bot.js — Gast-Bot; tritt einem Raum als WHITE über PeerJS/WebRTC bei.

• pente-host.js — Host-Adapter; eröffnet einen Raum als BLACK.

• pente_scan.py — eigenständiger Bedrohungsscanner für das Spielfeld (offene Vierer, Capture-Frames, auffüllbare Lücken, Gewinnfelder) für sichereres Spiel.

• webrtc-polyfill.js — lässt PeerJS in Node laufen (@roamhq/wrtc-Shim).

• test/fake-host.js — protokolltreuer Host für Headless-Bot-Tests.

• docs/ — die Design-Spezifikation.

Wie es funktioniert

Der Mehrspielermodus des Browser-Spiels verwendet PeerJS, um zwei Peers zu verbinden. Die Host-Peer-ID eines Raums ist chanblake-pente-v3-<roomcode>. Der Gast-Bot verbindet sich mit dieser ID, sendet hello / sync-request des Spiels und kommuniziert über move-request — kein Browser nötig, nur eine WebRTC-Implementierung. pente-host.js spiegelt dasselbe Protokoll auf der Host-Seite wider. Der Python-MCP-Server kapselt beides als Tools.

Voraussetzungen

• Node.js (@roamhq/wrtc-Shim — siehe webrtc-polyfill.js)

• Python ≥ 3.11 mit mcp (pip install mcp)

• Internetzugang zur öffentlichen PeerJS-Cloud (0.peerjs.com:443)

Schnellstart

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

Registriere den Server in einem MCP-Client und führe dann Folgendes aus:

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")

Ein Mensch öffnet https://chanblake.github.io/pente/?room=ABC234 und spielt — die KI ist der Gegner.

Scanne ein Spielfeld vor dem Zug:

python pente_scan.py board.json

Anerkennung

Das Spiel, mit dem sich dieses Projekt verbindet, ist ChanBlake's Pente: https://github.com/ChanBlake/pente — eine inoffizielle, unabhängige Integrationsschicht. Dieses Projekt sendet nur Netzwerkzüge; es kann die Dateien oder den Speicher des Spiels nicht verändern.

Bekannte Einschränkungen

• Raumcodes: Die App entfernt I, O und 0 aus Codes. create erzeugt nur Codes aus dem eigenen Alphabet der App ABCDEFGHJKLMNPQRSTUVWXYZ23456789, daher lassen sich Einladungen immer auf 6 Zeichen parsen.

• Nur öffentliche Cloud: Ein lokaler PeerServer + Node-Host registriert seinen Peer nicht (Einschränkung von WebRTC in Node). Verwende die öffentliche Cloud.

• Ein einzelner aktiver Spieltisch pro Serverprozess.

Lizenz

MIT — diese Integrationsschicht. ChanBlake's Spiel hat eine eigene Lizenz (siehe sein Repository).