mcpField
C
Codeforces MCP Server

Codeforces MCP Server

远程服务
github.com/ketherworks开发工具07 周前更新
代码仓库

关于 Codeforces MCP Server

Codeforces MCP Server 是通过官方 Codeforces API 查询题目及公开元数据的 MCP 服务,适用于查找题目和查看题目详情。它仅提供读取操作,不要求 API 密钥或裁判账户凭据。

主要功能

  1. 01按标题、编号、评分或标签搜索题目
  2. 02按编号获取官方题目元数据
  3. 03查看服务健康状态与 API 观测
  4. 04报告可用的读取操作和传输方式

适用场景

  1. 01查找符合标签和难度条件的题目
  2. 02根据题目编号核对公开元数据

MCP 相关

它向 MCP 客户端提供题目搜索、元数据查询、健康检查和能力报告工具。可通过托管 HTTP 端点或本地 stdio 连接。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Codeforces MCP 服务

简体中文

通过一个轻量级 MCP 服务搜索 Codeforces 官方题目元数据。

快速开始

将托管服务添加到 MCP 配置中:

{
  "servers": {
    "codeforces": {
      "type": "http",
      "url": "https://codeforces-mcp.ksrnyx.top/mcp"
    }
  }
}

该端点接受匿名只读请求。无需 API 密钥、Cookie 或评测账户。

然后询问:

Find five beginner Codeforces problems tagged implementation.

功能

工具用途
oj_capabilities报告可用的 Codeforces 只读操作和传输方式。
oj_health报告服务健康状态和最新的官方 API 观测结果。
oj_search_problems按标题、ID、评分或标签搜索官方题集。
codeforces_get_problem_metadata按 ID 获取官方元数据,例如 158/A、158A 或 158-A。

本地运行

需要 Node.js 22 或更高版本。

npm ci
npm run check
npm run build
node packages/codeforces/dist/index.js

从源代码检出配置 MCP 客户端:

{
  "servers": {
    "codeforces": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/packages/codeforces/dist/index.js"]
    }
  }
}

带标签的 GitHub 发布版本会附带独立的 npm 压缩包。

可用性

  • 托管的 MCP 服务:https://codeforces-mcp.ksrnyx.top/mcp
  • 官方 MCP Registry:io.github.ketherworks/codeforces,由 server.json 描述
  • 健康状态:查看仓库主页或调用 oj_health

源代码与安全

此独立发布版本由经过审核的 Competitive Programming MCP 源代码生成。 发布包包含共享的 OJ 契约实现,因此其运行时不依赖未发布的工作区包。

平台规则

本项目为非官方项目,与 Codeforces 无关联,也未获其认可。

该服务不提供运行或提交工具,也不接受评测账户凭据。有关安全边界,请参阅 SECURITY.md;有关规范源代码修订版本,请参阅 PROVENANCE.md。

开发

npm ci
npm run check
npm run pack:check
npm run deploy:dry

许可证

适配器源代码采用 MIT 许可证。题目内容和商标不因本仓库而重新授权。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。