Rubik's Cube MCP Server

Instructions

Implementation Reference

• src/app.ts:34-79 (handler)

  Executes the startCube tool: creates a new game session with RubiksCube, scrambles if requested, sets up visualization, generates game ID and UI link.

  async ({ scramble = true, difficulty = 20 }: { scramble?: boolean; difficulty?: number }) => {
    const gameId = `cube_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
    const cube = new RubiksCube();
  
    if (scramble) {
      cube.scramble(difficulty);
    }
  
    const session: GameSession = {
      id: gameId,
      cubeState: cube.getState(),
      createdAt: Date.now(),
      lastActivity: Date.now(),
      status: 'active',
      scrambleMoves: difficulty
    };
  
    this.games.set(gameId, { cube, session });
    this.visualizationServer.registerSession(session);
  
    const currentState = cube.getState();
    const response: CubeResponse = {
      gameId,
      cube: currentState,
      scrambleMoves: difficulty,
      nextAction: currentState.solved ? "finish" : "manipulateCube"
    };
  
    // MCP UI 리소스 생성 (예: 게임 링크)
    const gameUrl = `http://localhost:3000/game/${gameId}`;
    const uiResponse = {
      type: "resource",
      resource: {
        uri: `ui://game-link/${gameId}`,
        mimeType: "text/html",
        text: `<a href="${gameUrl}" target="_blank">Click to Play!</a>`
      }
    } as const;
  
    return {
      content: [
        uiResponse,
        { type: "text", text: JSON.stringify(response, null, 2) }
      ]
    };
  }

• src/app.ts:30-33 (schema)

  Zod input schema for the startCube tool parameters.

  {
    scramble: z.boolean().optional().describe("Whether to scramble the cube initially"),
    difficulty: z.number().min(1).max(100).optional().describe("Number of scramble moves (1-100)")
  },

• src/app.ts:28-80 (registration)

  Registers the startCube tool with the MCP server, specifying name, description, input schema, and handler function.

    "startCube",
    "Initialize a new Rubik's Cube game session",
    {
      scramble: z.boolean().optional().describe("Whether to scramble the cube initially"),
      difficulty: z.number().min(1).max(100).optional().describe("Number of scramble moves (1-100)")
    },
    async ({ scramble = true, difficulty = 20 }: { scramble?: boolean; difficulty?: number }) => {
      const gameId = `cube_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
      const cube = new RubiksCube();
  
      if (scramble) {
        cube.scramble(difficulty);
      }
  
      const session: GameSession = {
        id: gameId,
        cubeState: cube.getState(),
        createdAt: Date.now(),
        lastActivity: Date.now(),
        status: 'active',
        scrambleMoves: difficulty
      };
  
      this.games.set(gameId, { cube, session });
      this.visualizationServer.registerSession(session);
  
      const currentState = cube.getState();
      const response: CubeResponse = {
        gameId,
        cube: currentState,
        scrambleMoves: difficulty,
        nextAction: currentState.solved ? "finish" : "manipulateCube"
      };
  
      // MCP UI 리소스 생성 (예: 게임 링크)
      const gameUrl = `http://localhost:3000/game/${gameId}`;
      const uiResponse = {
        type: "resource",
        resource: {
          uri: `ui://game-link/${gameId}`,
          mimeType: "text/html",
          text: `<a href="${gameUrl}" target="_blank">Click to Play!</a>`
        }
      } as const;
  
      return {
        content: [
          uiResponse,
          { type: "text", text: JSON.stringify(response, null, 2) }
        ]
      };
    }
  );