MCP CONNECT 4

by tolios

205 downloads
Not rated
GitHub

About

MCP Connect 4 is an MCP server that lets a user and an AI assistant play a game of Connect 4. The assistant controls the game state and makes moves for both itself and the user, enabling turn‑based gameplay through an LLM client.

Details

Author
tolios
Downloads
205
Categories
Other

- Provides structured game state for Connect 4
- Assistant plays moves for both players
- Simple setup with uv and a local Python script
- Game progress visible in the LLM chat’s tool calls
- Lightweight, single‑purpose implementation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP CONNECT 4
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository and add a JSON entry to your Claude (or compatible client) configuration. The entry must specify the absolute path to uv as the command, the repository directory with --directory, and run main.py as the arguments. After configuration, the assistant can start a Connect 4 game using the provided tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp connect 4": {
            "connect4": {
                "command": "absolute path to uv",
                "args": [
                    "--directory",
                    "absolute path to this repo",
                    "run",
                    "main.py"
                ]
            }
        }
    }
}

McpServers

{
    "connect4": {
        "command": "absolute path to uv",
        "args": [
            "--directory",
            "absolute path to this repo",
            "run",
            "main.py"
        ]
    }
}
# MCP CONNECT 4 While people use MCP to build powerful connections with various tools like db's or the web one can imagine a great and perhaps more advanced interaction between user and assistant, would be to play a game. So I say why not. Let's play games! This is the premise behind this repo. Also its fun! MCP Connect 4 offers structure to the state of the game. The assistant plays the move it believes and also plays your move. (this might be a criticism) ## How to use Simply clone the repo and add the following to the json config of claude (or massage similarly for other clients) this: ```json { "connect4": { "command": "absolute path to uv", "args": [ "--directory", "absolute path to this repo", "run", "main.py" ] } } ``` Currently one can view the board by seeing the tool call from the chat of the LLM provider (should do better)...
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.