reversi-mcp-ui — Claude Code MCP server: features and setup
The reversi-mcp-ui MCP server enforces Reversi rules and validates moves during games against an AI opponent.
MIT 184 installs updated 2025-10-15
claude mcp add --transport http reversi-mcp-ui https://reversi-mcp-ui--mfukushim.run.toolsWhat reversi-mcp-ui does
The server isolates game logic inside the MCP runtime instead of relying on prompt instructions. An internal engine validates every move and updates match state in session memory. Dedicated tools handle player and assistant turns through select-user and select-assistant. Starting fresh uses new-game.
HTML board updates travel via the ui:// schema. If a client feeds raw interface markup directly to the language model, token costs climb rapidly. Full interactive clicking requires client UI Actions support, so standard setups rely on coordinate text in conversation.
Running local tests via Wrangler inside a Docker container may cause failures. For standard remote setups, connecting to the HTTP endpoint provides a direct link without local builds.
What it helps with
- play Reversi against an AI model inside the chat
- prevent AI opponents from cheating board rules
- verify client support for experimental MCP-UI actions
- test server-side game state tracking over HTTP
Example prompts for the agent
- Start a fresh Reversi match with
new-game - Put a black stone on the board using
select-user - Pass the current turn using
PASSwithselect-user
How to install reversi-mcp-ui
Platform CLI: remote server
claude mcp add --transport http reversi-mcp-ui https://reversi-mcp-ui--mfukushim.run.toolsPlatform CLI: remote server
codex mcp add reversi-mcp-ui --url https://reversi-mcp-ui--mfukushim.run.toolsConfig file
{
"mcpServers": {
"reversi-mcp-ui": {
"url": "https://reversi-mcp-ui--mfukushim.run.tools"
}
}
}Config file
{
"servers": {
"reversi-mcp-ui": {
"type": "http",
"url": "https://reversi-mcp-ui--mfukushim.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http reversi-mcp-ui https://reversi-mcp-ui--mfukushim.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about reversi-mcp-ui
How do I install reversi-mcp-ui in Claude Code?
Run claude mcp add --transport http reversi-mcp-ui https://reversi-mcp-ui--mfukushim.run.tools in your terminal.
Why does the MCP server handle Reversi rules?
Moving rule logic to the server stops the AI from cheating. The model cannot alter board state or execute illegal moves because the server validates every step.
What causes high token usage with this server?
Board states return HTML markup using the ui:// schema. If your MCP client parses this interface data through the LLM on each move, context tokens deplete quickly.