mcp-server-leetcode

Implementation Reference

• src/tools/contest-tools.ts:37-52 (handler)

  The handler function that executes the tool: fetches user contest ranking using LeetCodeService, returns formatted JSON or error response.

  async ({ username }) => {
    try {
      const data = await leetcodeService.fetchUserContestRanking(username);
      return {
        content: [{ 
          type: "text", 
          text: JSON.stringify(data, null, 2)
        }]
      };
    } catch (error: unknown) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      return {
        content: [{ type: "text", text: `Error: ${errorMessage}` }],
        isError: true
      };
    }

• src/tools/contest-tools.ts:34-36 (schema)

  Zod input schema defining the 'username' parameter for the tool.

  {
    username: z.string().describe("LeetCode username")
  },

• src/tools/contest-tools.ts:32-54 (registration)

  Registration of the 'get-user-contest-ranking' tool on the MCP server within registerContestTools.

  server.tool(
    "get-user-contest-ranking",
    {
      username: z.string().describe("LeetCode username")
    },
    async ({ username }) => {
      try {
        const data = await leetcodeService.fetchUserContestRanking(username);
        return {
          content: [{ 
            type: "text", 
            text: JSON.stringify(data, null, 2)
          }]
        };
      } catch (error: unknown) {
        const errorMessage = error instanceof Error ? error.message : String(error);
        return {
          content: [{ type: "text", text: `Error: ${errorMessage}` }],
          isError: true
        };
      }
    }
  );

• src/services/leetcode-service.ts:108-110 (helper)

  LeetCodeService helper method that calls the GraphQL query for user contest ranking data.

  async fetchUserContestRanking(username: string) {
    return this.executeQuery(userContestRankingQuery, { username });
  }

• src/graphql/queries.ts:197-223 (helper)

  GraphQL query used to fetch user contest ranking and history data from LeetCode API.

  export const userContestRankingQuery = `
    query userContestRankingInfo($username: String!) {
      userContestRanking(username: $username) {
        attendedContestsCount
        rating
        globalRanking
        totalParticipants
        topPercentage
        badge {
          name
        }
      }
      userContestRankingHistory(username: $username) {
        attended
        trendDirection
        problemsSolved
        totalProblems
        finishTimeInSeconds
        rating
        ranking
        contest {
          title
          startTime
        }
      }
    }
  `;

• src/index.ts:24-24 (registration)

  Invocation of registerContestTools in main server setup, which registers the tool.

  registerContestTools(server, leetcodeService);