FIAR

An MCP server that runs Four in a Row against Copilot with a Spring Boot-based MCP endpoint.

other

2

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jeffreygroneberg-mcp-fiar": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-Dspring.main.web-application-type=none",
        "-Dlogging.pattern.console=",
        "-jar",
        "${workspaceFolder}/target/mcp-fiar-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

You can run an MCP server that lets you play Four in a Row (Connect Four) against GitHub Copilot inside a Spring Boot environment. This server uses the Model Context Protocol (MCP) to coordinate gameplay, board updates, and game state between you and Copilot, providing a smooth turn-based experience directly in your MCP client.

How to use

Once the MCP server is running, you interact with it through your MCP client. Start a new game prompt in your Copilot chat, for example: “Let’s play Four in a Row” or “Start a Four in a Row game with a 6×6 grid.” Copilot will create a new game and you will take turns placing pieces by specifying the target column.

How to install

Prerequisites before you begin:

Java JDK 17 or later

Maven 3.6 or later

Visual Studio Code with the GitHub Copilot extension installed

Then perform these steps to run the MCP server locally:

# 1. Build the project
./mvnw clean install

# 2. Start the MCP server (within an environment that provides the required MCP config)
java \
  -Dspring.ai.mcp.server.stdio=true \
  -Dspring.main.web-application-type=none \
  -Dlogging.pattern.console= \
  -jar target/mcp-fiar-0.0.1-SNAPSHOT.jar

Additional sections

Configuration and command usage details are shown in the MCP entry for the server. The server runs as a local process via Java and does not expose a web UI. Use your MCP client to prompt Copilot to start or join games and to issue moves by specifying a column number.

Key game commands you can use during gameplay include:

1 to 7 — Drop your piece in the specified column
Show me the board — Display the current board state
Reset all games — Clear all stored games
Get all games — List all active and completed games

Available tools

Show board

Display the current board state so you can verify the location of all pieces after each move.

Reset all games

Clear all stored games to start fresh play sessions.

Get all games

List all active and completed games so you can manage multiple matches.

Drop piece

Place a piece in a specified column to make your move and progress the game.