CAIE题库搜索服务器

SearchCAIE MCP Server是一个独立的MCP服务器,用于搜索CAIE历年试题,支持单主题和多主题查询,提供多种过滤选项和LLM友好的工具响应。

  • by Pixel2075
  • Python
  • 混合部署
  • 1 星标
  • 更新于
在 GitHub 查看 Pixel2075/searchcaie-mcp

使用说明

搜索CAIE MCP服务器

用于搜索CAIE过去论文的独立MCP服务器。

特性

  • 用于单主题和多主题查询的核心搜索工具
  • 主题、论文、年份、会话、章节、模式和分页过滤器
  • LLM友好的工具响应:简洁的文本预览和结构化的JSON
  • 多主题搜索返回 recommended_ids 用于快速后续检索
  • get_questions 支持两者 compact (默认)和 full 细节模式
  • 向后兼容的输入:逗号分隔的字符串和本机数组
  • 上游重试和结构化错误处理

工具行为说明

  • search_multi 接受其中之一 topics (逗号分隔字符串)或 topics_list (数组)
  • get_questions 接受其中之一 question_ids (逗号分隔字符串)或 question_ids_list (数组)
  • get_questions 默认为 detail="compact" 减少令牌使用并提高LLM应答质量

安装

pip install .

或者从git:

pip install "git+https://github.com/Pixel2075/searchcaie-mcp.git"

Claude桌面配置

{
  "mcpServers": {
    "searchcaie-search": {
      "command": "searchcaie-mcp",
      "env": {
        "MCP_API_BASE": "https://api.searchcaie.com/api"
      }
    }
  }
}

MCP_DEFAULT_SUBJECT 是可选的。如果省略,服务器将不应用 默认情况下使用主题过滤器。

环境变量

  • MCP_API_BASE (默认值: https://api.searchcaie.com/api)
  • MCP_DEFAULT_SUBJECT (可选;如果未设置,则不应用默认主题过滤器)
  • MCP_REQUEST_TIMEOUT (默认值: 30)
  • MCP_TRANSPORT (默认值: stdio)
  • MCP_HOST (默认值: 127.0.0.1)
  • MCP_PORT (默认值: 8000)
  • MCP_PATH (默认值: /mcp)

直接运行

searchcaie-mcp

作为远程MCP服务器运行

MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
MCP_PATH=/mcp \
searchcaie-mcp