Rubik's Cube MCP Server

Instructions

Implementation Reference

• src/app.ts:89-111 (handler)

  Executes the joinGame tool logic: retrieves the game session by ID, fetches current cube state, constructs response, and returns formatted content.

  async ({ gameId }: { gameId: string }) => {
    const game = this.games.get(gameId);
    if (!game) {
      throw new Error(`Game session ${gameId} not found`);
    }
  
    const { cube, session } = game;
    const currentState = cube.getState();
  
    const response: CubeResponse = {
      gameId,
      cube: currentState,
      scrambleMoves: session.scrambleMoves,
      nextAction: currentState.solved ? "finish" : "manipulateCube",
    };
  
    return {
      content: [
        { type: "text", text: "Joined game successfully." },
        { type: "text", text: JSON.stringify(response, null, 2) },
      ],
    };
  }

• src/app.ts:86-88 (schema)

  Input schema definition using Zod for the joinGame tool, requiring a gameId string parameter.

  {
    gameId: z.string().describe("The game session ID to join"),
  },

• src/app.ts:83-112 (registration)

  Registers the joinGame MCP tool with name, description, input schema, and handler function on the MCP server.

  this.mcpServer.tool(
    "joinGame",
    "Join an existing Rubik's Cube game session",
    {
      gameId: z.string().describe("The game session ID to join"),
    },
    async ({ gameId }: { gameId: string }) => {
      const game = this.games.get(gameId);
      if (!game) {
        throw new Error(`Game session ${gameId} not found`);
      }
  
      const { cube, session } = game;
      const currentState = cube.getState();
  
      const response: CubeResponse = {
        gameId,
        cube: currentState,
        scrambleMoves: session.scrambleMoves,
        nextAction: currentState.solved ? "finish" : "manipulateCube",
      };
  
      return {
        content: [
          { type: "text", text: "Joined game successfully." },
          { type: "text", text: JSON.stringify(response, null, 2) },
        ],
      };
    }
  );