Mcp Server Leetcode

What is Mcp Server Leetcode about?

Enables AI assistants to query LeetCode data such as daily challenges, problem details, user statistics, and contest rankings through a Model Context Protocol (MCP) server.

How to use Mcp Server Leetcode?

Installation

• Via Smithery (recommended for Claude Desktop): npx -y @smithery/cli install @doggybee/mcp-server-leetcode --client claude
• Global npm: npm install -g @mcpfun/mcp-server-leetcode
• Local project: npm install @mcpfun/mcp-server-leetcode

Running

• After installation, start the server with the command mcp-server-leetcode (or via npx -y @doggybee/mcp-server-leetcode).

Configuration Add the server to claude_desktop_config.json:

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

For local development, point to the built script:

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

Library usage

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

Key features

• 🚀 Fast wrapper around the official LeetCode API
• 🔍 Search problems with filters for tags, difficulty, pagination
• 📅 Retrieve daily challenge instantly
• 👤 Access user profiles, submission history, and contest rankings
• 🏆 Query contest details and rankings
• 🧩 Fully compatible with MCP tools (CLI and programmable API)
• 📦 Available as a CLI command and as an importable library

Use cases

• Integrating LeetCode data into AI coding assistants (e.g., Claude for Desktop)
• Building custom dashboards that show personal LeetCode stats
• Automating study schedules by pulling daily challenges and problem lists
• Developing bots that suggest problems based on difficulty or tags
• Analyzing contest performance across multiple users

FAQ

Q: Do I need an API key? A: No API key is required; the server communicates with the public LeetCode endpoints.

Q: Which platforms are supported? A: It runs on any system with Node.js (v14+).

Q: Can I run the server locally without installing globally? A: Yes, install the package locally and start it with npx -y @doggybee/mcp-server-leetcode.

Q: How do I limit the number of returned problems? A: Use the limit parameter in the search-problems tool or the corresponding library method.

Q: Is the project open source? A: Yes, it is licensed under the MIT License and hosted on GitHub.

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