关于 Codeforces MCP Server
Codeforces MCP Server 是通过官方 Codeforces API 查询题目及公开元数据的 MCP 服务,适用于查找题目和查看题目详情。它仅提供读取操作,不要求 API 密钥或裁判账户凭据。
主要功能
- 01按标题、编号、评分或标签搜索题目
- 02按编号获取官方题目元数据
- 03查看服务健康状态与 API 观测
- 04报告可用的读取操作和传输方式
适用场景
- 01查找符合标签和难度条件的题目
- 02根据题目编号核对公开元数据
MCP 相关
它向 MCP 客户端提供题目搜索、元数据查询、健康检查和能力报告工具。可通过托管 HTTP 端点或本地 stdio 连接。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http ketherworks-codeforces https://codeforces-oj-mcp.lantangtang54.workers.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"ketherworks-codeforces":{"type":"http","url":"https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"ketherworks-codeforces":{"type":"http","url":"https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"ketherworks-codeforces":{"type":"http","url":"https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"ketherworks-codeforces":{"serverUrl":"https://codeforces-oj-mcp.lantangtang54.workers.dev/mcp"}}}命令在终端中运行;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
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。