MCP LeetCode

A feature-rich LeetCode MCP Server written in Python, supporting both leetcode.com and leetcode.cn.

Features

• 🌐 Dual Site Support - leetcode.com (Global) & leetcode.cn (China)
• 🔍 Problem Query - Search, filter, and get problem details
• 👤 User Data - Profile, submissions, progress, contest info
• 💻 Code Execution - Run and submit code
• 📝 Notes Management - CRUD operations (CN only)
• ⚡ Smart Caching - Reduce API calls with built-in cache
• 🛡️ Type Safe - Full Pydantic v2 type definitions

Quick Start

Installation

pip install mcp-leetcode

Configuration

cp config.example.yaml config.yaml
# Edit config.yaml with your settings

Run

mcp-leetcode

MCP Client Configuration

Claude Desktop

{
  "mcpServers": {
    "leetcode": {
      "command": "mcp-leetcode",
      "env": {
        "LEETCODE_SITE": "cn",
        "LEETCODE_SESSION": "your_session_cookie",
        "LEETCODE_CSRF": "your_csrf_token"
      }
    }
  }
}

VS Code (Copilot)

{
  "mcp": {
    "servers": {
      "leetcode": {
        "command": "mcp-leetcode",
        "env": {
          "LEETCODE_SITE": "cn"
        }
      }
    }
  }
}

Available Tools

Problems

Tool	Description
get_daily_challenge	Get today's daily challenge
get_problem	Get problem details by slug
search_problems	Search with filters (tags, difficulty, keywords)
get_problem_solutions	Get community solutions

Users

Tool	Description
get_user_profile	Get user profile information
get_user_submissions	Get submission history
get_user_progress	Get problem-solving progress
get_contest_info	Get contest ranking info

Code Execution

Tool	Description
run_code	Run code with test cases
submit_solution	Submit code to LeetCode

Notes (CN only)

Tool	Description
get_notes	Get user notes
create_note	Create a new note
update_note	Update existing note

Development

# Clone
git clone https://github.com/LYCGGG/mcp-leetcode.git
cd mcp-leetcode

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

License

MIT