简介

MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。

简介

MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。

LeetCode MCP 服务器

LeetCode MCP Server 是一个基于 模型上下文协议 (MCP) 的服务，提供与 LeetCode API 的无缝集成，实现与 LeetCode 编程题目、竞赛、题解和用户数据的高级自动化和智能交互。

特性

• 🌐 多站点支持：同时支持 leetcode.com（全球）和 leetcode.cn（中国）站点
• 📊 ​题目数据获取：获取详细的题目描述、约束条件、示例、官方题解和用户提交的解答
• 👤 用户数据访问：检索用户资料、提交历史和竞赛表现
• 🔒 私有数据访问：创建和查询用户笔记，跟踪题目解答进度，分析提交详情（AC/WA 报告）
• 🔍 高级搜索功能：按标签、难度级别、分类和关键字筛选题目
• 📅 每日一题获取：轻松访问每日一题

前提条件

1. Node.js (v20.x 或更高版本)
2. （可选）LeetCode 会话 cookie，用于授权访问 API

安装

通过 Smithery 安装

使用 Smithery 为 Claude Desktop 自动安装 leetcode-mcp-server：

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

手动安装

# 从 npm 安装
npm install @jinzcdev/leetcode-mcp-server -g

# 使用中国站点配置运行
npx -y @jinzcdev/leetcode-mcp-server --site cn

# 使用认证运行（访问私有数据）
npx -y @jinzcdev/leetcode-mcp-server --site cn --session <您的 LEETCODE 会话 COOKIE>

或者，您可以克隆仓库并在本地运行：

# 克隆仓库
git clone https://github.com/jinzcdev/leetcode-mcp-server.git

# 导航到项目目录
cd leetcode-mcp-server

# 构建项目
npm install && npm run build

# 运行服务器
node build/index.js --site cn

使用方法

Visual Studio Code 集成

在您的用户设置 (JSON) 文件中添加以下配置。通过按 Ctrl/Cmd + Shift + P 并搜索 Preferences: Open User Settings (JSON) 来访问此文件。

方式一：使用环境变量

{
  "mcp": {
    "servers": {
      "leetcode": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@jinzcdev/leetcode-mcp-server"],
        "env": {
          "LEETCODE_SITE": "cn",
          "LEETCODE_SESSION": "<您的 LEETCODE 会话 COOKIE>"
        }
      }
    }
  }
}

方式二：使用命令行参数

{
  "mcp": {
    "servers": {
      "leetcode": {
        "type": "stdio",
        "command": "npx",
        "args": [
          "-y",
          "@jinzcdev/leetcode-mcp-server",
          "--site",
          "cn",
          "--session",
          "<您的 LEETCODE 会话 COOKIE>"
        ]
      }
    }
  }
}

对于 LeetCode 全球站点，请将 --site 参数修改为 global。

[!TIP]

服务支持以下可选的环境变量：

• LEETCODE_SITE：LeetCode API 端点（'global' 或 'cn'，默认为 'global'）
• LEETCODE_SESSION：用于授权 API 访问的 LeetCode 会话 cookie（默认为空）

优先级说明：

当同时指定命令行参数和环境变量时，命令行参数优先。例如：

• 如果设置了 LEETCODE_SITE=cn 但您运行 leetcode-mcp-server --site global，服务器将使用 global。
• 如果存在 LEETCODE_SESSION 但您提供了 --session "new_cookie"，将使用命令行中的参数值。

可用工具

题目

用户

提交 / 运行

笔记

题解

工具参数

题目

• get_daily_challenge - 获取今天的 LeetCode 每日一题及完整详情

  • 无需参数

• get_problem - 获取特定 LeetCode 题目的详情

  • titleSlug：题目的 URL 标识符（字符串，必需）

• search_problems - 基于多种过滤条件搜索 LeetCode 题目

  • category：题目类别过滤器（字符串，可选，默认："all-code-essentials"）
  • tags：按主题标签过滤题目的列表（字符串数组，可选）
  • difficulty：题目难度级别过滤器（枚举："EASY"、"MEDIUM"、"HARD"，可选）
  • searchKeywords：在题目标题和描述中搜索的关键词（字符串，可选）
  • limit：返回的最大题目数量（数字，可选，默认：10）
  • offset：要跳过的题目数量（数字，可选）

用户

• get_user_profile - 获取 LeetCode 用户的资料信息

  • username：LeetCode 用户名（字符串，必需）

• get_user_contest_ranking - 获取用户的竞赛排名信息

  • username：LeetCode 用户名（字符串，必需）
  • attended：是否只包括用户参加过的竞赛（布尔值，可选，默认：true）

• get_recent_submissions - 获取用户在 LeetCode 全球站的近期提交

  • username：LeetCode 用户名（字符串，必需）
  • limit：返回的最大提交数量（数字，可选，默认：10）

• get_recent_ac_submissions - 获取用户的近期已接受提交

  • username：LeetCode 用户名（字符串，必需）
  • limit：返回的最大提交数量（数字，可选，默认：10）

• get_user_status - 获取当前已认证用户的状态

  • 无需参数

• get_problem_submission_report - 获取特定提交的详细信息

  • id：提交的数字 ID（数字，必需）

• get_problem_progress - 获取已认证用户的题目解决状态

  • offset：要跳过的题目数量（数字，可选，默认：0）
  • limit：返回的最大题目数量（数字，可选，默认：100）
  • questionStatus：按题目状态过滤（枚举："ATTEMPTED"、"SOLVED"，可选）
  • difficulty：按难度级别过滤（字符串数组，可选）

• get_all_submissions - 获取用户提交的分页列表

  • limit：返回的最大提交数量（数字，默认：20）
  • offset：要跳过的提交数量（数字，默认：0）
  • questionSlug：可选的题目标识符（字符串，可选）
  • lang：编程语言过滤器（字符串，可选，仅中国站）
  • status：提交状态过滤器（枚举："AC"、"WA"，可选，仅中国站）
  • lastKey：用于检索下一页的分页令牌（字符串，可选，仅中国站）

提交 / 运行

• run_code - 运行指定题目的代码并等待结束（需要认证）

  • titleSlug：题目的 URL 标识符（字符串，必需）
  • lang：编程语言（字符串枚举，必需）
  • typedCode：要运行的源码（字符串，必需）
  • dataInput：自定义运行输入（字符串，可选）
  • timeoutMs：轮询超时毫秒数（数字，可选，默认：120000）
  • pollIntervalMs：轮询间隔毫秒数（数字，可选，默认：1500）

• submit_solution - 提交指定题目的代码并等待结束（需要认证）

  • titleSlug：题目的 URL 标识符（字符串，必需）
  • lang：编程语言（字符串枚举，必需）
  • typedCode：要提交的源码（字符串，必需）
  • timeoutMs：轮询超时毫秒数（数字，可选，默认：120000）
  • pollIntervalMs：轮询间隔毫秒数（数字，可选，默认：1500）

笔记

• search_notes - 搜索 LeetCode 中国站上的用户笔记

  • keyword：过滤笔记的搜索词（字符串，可选）
  • limit：返回的最大笔记数量（数字，可选，默认：10）
  • skip：要跳过的笔记数量（数字，可选，默认：0）
  • orderBy：返回笔记的排序顺序（枚举："ASCENDING"、"DESCENDING"，可选，默认："DESCENDING"）

• get_note - 获取特定 LeetCode 题目的用户笔记

  • questionId：LeetCode 题目的题目 ID（字符串，必需）
  • limit：返回的最大笔记数量（数字，可选，默认：10）
  • skip：要跳过的笔记数量（数字，可选，默认：0）

• create_note - 为特定 LeetCode 题目创建新笔记

  • questionId：LeetCode 题目的题目 ID（字符串，必需）
  • content：笔记内容，支持 markdown 格式（字符串，必需）
  • summary：可选的笔记简短摘要或标题（字符串，可选）

• update_note - 使用新内容或摘要更新现有笔记

  • noteId：要更新的笔记 ID（字符串，必需）
  • content：笔记的新内容，支持 markdown 格式（字符串，必需）
  • summary：可选的新简短摘要或标题（字符串，可选）

题解

• list_problem_solutions - 获取特定题目的社区题解文章列表

  • questionSlug：题目的 URL 标识符（字符串，必需）
  • limit：返回的最大题解文章数量（数字，可选，默认：10）
  • skip：要跳过的题解文章数量（数字，可选）
  • userInput：过滤题解文章的搜索词（字符串，可选）
  • tagSlugs：用于过滤题解文章的标签标识符数组（字符串数组，可选，默认：[])
  • orderBy：题解文章的排序条件
    • 全球站：枚举："HOT"、"MOST_RECENT"、"MOST_VOTES"，可选，默认："HOT"
    • 中国站：枚举："DEFAULT"、"MOST_UPVOTE"、"HOT"、"NEWEST_TO_OLDEST"、"OLDEST_TO_NEWEST"，可选，默认："DEFAULT"

• get_problem_solution - 获取特定题解文章的完整内容

  • topicId：题解文章的唯一主题 ID（字符串，必需，仅全球站）
  • slug：题解文章的唯一标识符（字符串，必需，仅中国站）

可用资源

资源 URI

• problem-categories - 所有题目分类类别的列表

  • URI: categories://problems/all

• problem-tags - 算法和数据结构标签的详细集合

  • URI: tags://problems/all

• problem-langs - LeetCode 支持的所有编程语言的完整列表

  • URI: langs://problems/all

• problem-detail - 提供特定 LeetCode 题目的详情

  • URI: problem://{titleSlug}
  • 参数:
    • titleSlug: LeetCode URL 中显示的题目标识符

• problem-solution - 提供特定题解文章的完整内容

  • 全球站 URI: solution://{topicId}
    • 参数:
      • topicId: 题解文章的唯一主题 ID
  • 中国站 URI: solution://{slug}
    • 参数:
      • slug: 题解文章的唯一标识符

认证

访问用户特定数据需要 LeetCode 会话认证:

1. 登录 LeetCode（全球站 或 中国站）
2. 从浏览器开发者工具中提取 LEETCODE_SESSION cookie
3. 使用 --session 标志或 LEETCODE_SESSION 环境变量配置服务器

响应格式

所有工具都返回具有以下结构的 JSON 格式响应:

{
  "content": [
    {
      "type": "text",
      "text": "JSON_DATA_STRING"
    }
  ]
}

JSON_DATA_STRING 包含请求的数据或失败请求的错误消息。

许可证

本项目采用 MIT 许可证。

工具列表

• get_daily_challenge: Retrieves today's LeetCode Daily Challenge problem with complete details, including problem description, constraints, and examples

• get_problem: Retrieves details about a specific LeetCode problem, including its description, examples, constraints, and related information

• search_problems: Searches for LeetCode problems based on multiple filter criteria including categories, tags, difficulty levels, and keywords, with pagination support

• get_user_profile: Retrieves profile information about a LeetCode user, including user stats, solved problems, and profile details

• get_recent_ac_submissions: Retrieves a user's recent accepted (AC) submissions on LeetCode China, with details about each successfully solved problem

• get_user_status: Retrieves the current user's status on LeetCode, including login status, premium membership details, and user information (requires authentication)

• get_problem_submission_report: Retrieves detailed information about a specific LeetCode submission by its ID, including source code, runtime stats, and test results (requires authentication)

• get_problem_progress: Retrieves the current user's problem-solving status with filtering options, including detailed solution history for attempted or solved questions (requires authentication)

• get_all_submissions: Retrieves a list of the current user's submissions on LeetCode China with extensive filtering options, including pagination support via lastKey parameter (requires authentication)

• get_user_contest_ranking: Retrieves a user's contest ranking information on LeetCode, including overall ranking, participation history, and performance metrics across contests

• list_problem_solutions: Retrieves a list of community solutions for a specific LeetCode problem, including only metadata like article slug. To view the full content of a solution, use the 'get_problem_solution' tool with the slug returned by this tool.

• get_problem_solution: Retrieves the complete content and metadata of a specific solution, including the full article text, author information, and related navigation links

• search_notes: Searches for user notes on LeetCode with filtering options, returning note content and associated problem information (requires authentication)

• get_note: Retrieves user notes for a specific LeetCode problem by its question ID, returning the complete note content and metadata (requires authentication)

• create_note: Creates a new note for a specific LeetCode problem, allowing users to save personal comments and observations for future reference (requires authentication, CN only)

• update_note: Updates an existing note with new content or title, allowing users to refine their saved observations (requires authentication, CN only)

• run_code: Runs code for a LeetCode problem (requires authentication). Starts an interpret request then polls the /check/ endpoint until finished, returning both the start response and final check JSON.

• submit_solution: Submits code for a LeetCode problem (requires authentication). Starts a submission then polls the /check/ endpoint until finished, returning both the start response and final check JSON.

服务配置

[{'mcpServers': {'LeetCode': {'args': ['-y', '@jinzcdev/leetcode-mcp-server', '--site', 'cn'], 'command': 'npx', 'env': {}}}}]

来源

• 来源：github
• 链接：https://github.com/jinzcdev/leetcode-mcp-server