mcp-server-leetcode

Implementation Reference

• src/tools/contest-tools.ts:7-29 (registration)

  Primary registration of the 'get-contest-details' tool, including input schema (contestSlug: string) and inline handler that fetches data from LeetCodeService and returns formatted JSON response or error.

  server.tool(
    "get-contest-details",
    {
      contestSlug: z.string().describe("The URL slug of the contest")
    },
    async ({ contestSlug }) => {
      try {
        const data = await leetcodeService.fetchContestDetails(contestSlug);
        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/index.ts:24-24 (registration)

  Top-level registration call that invokes registerContestTools to add the get-contest-details tool (among others) to the MCP server.

  registerContestTools(server, leetcodeService);

• src/services/leetcode-service.ts:101-103 (helper)

  Supporting service method in LeetCodeService that executes the GraphQL query to fetch contest details by slug.

  async fetchContestDetails(contestSlug: string) {
    return this.executeQuery(contestDetailsQuery, { contestSlug });
  }

• src/graphql/queries.ts:177-195 (helper)

  GraphQL query definition used to fetch detailed contest information including title, description, timing, and participating questions.

  export const contestDetailsQuery = `
    query contestData($contestSlug: String!) {
      contest(titleSlug: $contestSlug) {
        title
        titleSlug
        description
        startTime
        duration
        originStartTime
        isVirtual
        questions {
          questionId
          title
          titleSlug
          difficulty
        }
      }
    }
  `;

• src/tools/contest-tools.ts:12-28 (handler)

  Inline handler function within the tool registration that processes the input, calls the service, and structures the MCP-compatible response.

  async ({ contestSlug }) => {
    try {
      const data = await leetcodeService.fetchContestDetails(contestSlug);
      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
      };
    }
  }