Agent 接入 🤖

把这个题库接进任意 AI agent —— 支持标准 MCP(给 Claude Code / Cursor 等)和开放 REST API(给任何程序 / 别人的 bot)。无需鉴权,开箱即用。

① REST API

公开只读接口,已开 CORS,直接 curl 或 fetch 即可。Base URL:https://你的域名

GET/api/categories全部分类(题量、难度)

GET/api/questions题目列表,支持 category / difficulty / q / limit / offset / fields=meta

GET/api/questions/:id单题详情(含大白话答案)

GET/api/random?category=rag随机出一题(可按分类)

GET/api/search?q=向量按关键词搜索题目/答案

示例

# 随机来一道 RAG 八股
curl "https://你的域名/api/random?category=rag"

# 按关键词搜
curl "https://你的域名/api/search?q=注意力"

# 只取题目元信息(不含答案),适合做列表
curl "https://你的域名/api/questions?difficulty=入门&fields=meta&limit=5"

② MCP 接入(Claude Code / Cursor 等)

MCP(Model Context Protocol)是 agent 调用外部工具的开放标准。接入后,你的 AI 助手就能直接「随机出题考我」「搜一道关于 MoE 的题」。

Claude Code:一条命令接入

claude mcp add ai-bagu \
  -e AI_BAGU_BASE=https://你的域名 \
  -- npx -y ai-bagu-mcp

或手动写进 MCP 配置(Cursor / Claude Desktop)

{
  "mcpServers": {
    "ai-bagu": {
      "command": "npx",
      "args": ["-y", "ai-bagu-mcp"],
      "env": { "AI_BAGU_BASE": "https://你的域名" }
    }
  }
}

接入后可用工具:list_categories、random_question、search_questions、get_question。源码见 GitHub 仓库 mcp/ 目录,也可本地 node mcp/server.mjs 直接跑。