洛谷题目 MCP 服务

洛谷题目 MCP（Model Context Protocol）服务，用于抓取和结构化洛谷编程题目信息，可与 Claude Desktop、Cursor、VS Code 等 AI 工具无缝集成。

在线演示

MCP 安装指南

本服务基于 Streamable HTTP 传输（JSON-RPC 2.0 over HTTP POST）运行，无需本地进程，直接配置远端 URL 即可使用。

MCP 端点地址：

https://workers-playground-steep-brook-cdfb.alphazhang689.workers.dev/mcp

---

Claude Desktop

编辑配置文件，加入以下内容：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "luogu": {
      "url": "https://workers-playground-steep-brook-cdfb.alphazhang689.workers.dev/mcp"
    }
  }
}

保存后重启 Claude Desktop，在对话中即可直接让 Claude 查询洛谷题目。

---

Cursor

1. 打开 Settings（Ctrl+, / Cmd+,）→ 搜索 MCP
2. 点击 Add new MCP server
3. 填写：
   • Name：luogu
   • Type：http
   • URL：https://workers-playground-steep-brook-cdfb.alphazhang689.workers.dev/mcp

---

VS Code（GitHub Copilot Chat）

在 .vscode/mcp.json 中添加：

{
  "servers": {
    "luogu": {
      "url": "https://workers-playground-steep-brook-cdfb.alphazhang689.workers.dev/mcp"
    }
  }
}

---

其他 MCP 客户端（Cline、Continue 等）

所有支持 Streamable HTTP 或 HTTP transport 的 MCP 客户端均可直接配置上方 URL。

---

可用工具

工具名	说明	参数
get_problem	获取洛谷题目完整信息（题面、格式、样例、难度、标签）	problem_id：题目编号，如 P1001、CF1234A、AT_abc123_a

支持的题目编号格式：P（普通）、B（入门）、CF（Codeforces）、AT（AtCoder）、SP（SPOJ）、UVA 等。

---

REST API

除 MCP 外，还提供 REST API 接口：

方法	路径	说明
GET	/api/problem/:id	通过题号获取题目，如 /api/problem/P1001
GET	/api/fetch?url=<题目URL>	通过完整 URL 获取题目

返回数据格式

{
  "id": "P1001",
  "url": "https://www.luogu.com.cn/problem/P1001",
  "title": "A+B Problem",
  "difficultyNum": 1,
  "difficulty": "入门",
  "tags": ["模拟", "数学"],
  "description": "输入两个整数 a, b，输出它们的和",
  "inputFormat": "两个用空格分开的整数",
  "outputFormat": "一个整数",
  "samples": [
    { "input": "1 2", "output": "3" }
  ],
  "limit": "时间限制：1.0s  内存限制：128MB"
}

---

MCP 协议参考

本服务遵循 MCP 规范 2025-11-25，使用 JSON-RPC 2.0 格式：

// 初始化
{ "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2025-11-25", "capabilities": {} } }

// 列出工具
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }

// 调用工具
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "get_problem", "arguments": { "problem_id": "P1001" } } }

---

本地开发 & 部署

# 安装依赖
npm install

# 本地开发（访问 http://localhost:8787）
npm run dev

# 运行测试
npm test

# 部署到 Cloudflare Workers
npm run deploy

许可证

本项目基于 MIT 许可证开源。