Mcp Server Leetcode

Mcp Server Leetcode

What is Mcp Server Leetcode about?

Mcp Server Leetcode exposes LeetCode data—problems, daily challenges, user profiles, submissions, and contest rankings—through a GraphQL interface, allowing AI agents and developers to fetch information on demand.

How to use Mcp Server Leetcode?

1. Installation
   • Global: npm install -g @mcpfun/mcp-server-leetcode
   • Local: npm install @mcpfun/mcp-server-leetcode
   • Smithery (Claude Desktop): npx -y @smithery/cli install @doggybee/mcp-server-leetcode --client claude
2. Run the server

   mcp-server-leetcode
   

3. Configure Claude Desktop (or any MCP‑compatible client)

   {
     "mcpServers": {
       "leetcode": {
         "command": "mcp-server-leetcode"
       }
     }
   }
   

4. Use as a library

   import { LeetCodeService } from '@mcpfun/mcp-server-leetcode';
   const svc = new LeetCodeService();
   const daily = await svc.getDailyChallenge();
   const problems = await svc.searchProblems({ difficulty: 'MEDIUM', tags: 'array+dynamic-programming' });
   

Key features

• Direct, low‑latency access to the official LeetCode API.
• GraphQL queries for fine‑grained data selection.
• CLI for quick ad‑hoc queries and debugging.
• Full tool set: daily challenge, problem lookup, search, user profile, submissions, and contest ranking.
• Designed for integration with MCP‑enabled AI assistants (e.g., Claude for Desktop).

Use cases

• AI tutoring bots that fetch problem statements and hints in real time.
• Dashboard widgets displaying a user's latest submissions or contest rank.
• Automated code reviewers that retrieve the original problem description for context.
• Personal productivity scripts that pull the daily challenge and store it locally.
• Research tools aggregating problem metadata for difficulty analysis.

FAQ

• Do I need a LeetCode account or API key? The server uses the public LeetCode endpoints; no API key is required for basic queries. Authenticated endpoints (e.g., private submission data) may require you to be logged in via the underlying library.
• Can I run the server locally without global installation? Yes, install the package locally and start it with npx @mcpfun/mcp-server-leetcode.
• Which GraphQL endpoint does it expose? The server starts a local GraphQL service (default port 4000) that mirrors LeetCode resources via the defined schema.
• Is the CLI compatible with Windows/macOS/Linux? The Node.js package works cross‑platform as long as Node ≥ 14 is installed.
• How do I contribute? Fork the repository, run npm run dev for hot‑reload development, and submit a pull request.

MCP Server LeetCode

A Model Context Protocol (MCP) server for LeetCode that enables AI assistants to access LeetCode problems, user information, and contest data.

Features

• 🚀 Fast access to LeetCode API
• 🔍 Search problems, retrieve daily challenges, and check user profiles
• 🏆 Query contest data and rankings
• 🧩 Full support for MCP tools and resources
• 📦 Provides both CLI and programmable API

Installation

Installing via Smithery

To install mcp-server-leetcode for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @doggybee/mcp-server-leetcode --client claude

Global Installation

npm install -g @mcpfun/mcp-server-leetcode

Once installed, you can run it directly from the command line:

mcp-server-leetcode

Local Installation

npm install @mcpfun/mcp-server-leetcode

Usage

Integration with Claude for Desktop

Add the following to your Claude for Desktop claude_desktop_config.json file:

{
  "mcpServers": {
    "leetcode": {
      "command": "mcp-server-leetcode"
    }
  }
}

For local development:

{
  "mcpServers": {
    "leetcode": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

Use as a Library

import { LeetCodeService } from '@mcpfun/mcp-server-leetcode';

// Initialize the service
const leetcodeService = new LeetCodeService();

// Get daily challenge
const dailyChallenge = await leetcodeService.getDailyChallenge();

// Search problems
const problems = await leetcodeService.searchProblems({
  difficulty: 'MEDIUM',
  tags: 'array+dynamic-programming'
});

Available Tools

Problem-related Tools

Tool Name	Description	Parameters
get-daily-challenge	Get the daily challenge	None
get-problem	Get details for a specific problem	titleSlug (string)
search-problems	Search for problems based on criteria	tags (optional), difficulty (optional), limit (default 20), skip (default 0)

User-related Tools

Tool Name	Description	Parameters
get-user-profile	Get user information	username (string)
get-user-submissions	Get user submission history	username (string), limit (optional, default 20)
get-user-contest-ranking	Get user contest rankings	username (string)

Contest-related Tools

Tool Name	Description	Parameters
get-contest-details	Get contest details	contestSlug (string)

Available Resources

Problem Resources

• leetcode://daily-challenge: Daily challenge
• leetcode://problem/{titleSlug}: Problem details
• leetcode://problems{?tags,difficulty,limit,skip}: Problem list

User Resources

• leetcode://user/{username}/profile: User profile
• leetcode://user/{username}/submissions{?limit}: User submissions
• leetcode://user/{username}/contest-ranking: User contest ranking

Local Development

Clone the repository and install dependencies:

git clone https://github.com/doggybee/mcp-server-leetcode.git
cd mcp-server-leetcode
npm install

Run in development mode:

npm run dev

Build the project:

npm run build

License

MIT

Related Projects

• Model Context Protocol - MCP specifications and documentation
• Claude for Desktop - AI assistant with MCP support

Acknowledgements

• This project was inspired by alfa-leetcode-api