文档处理服务

Atlas Docs MCP 服务器为 AI 助手提供库和框架的技术文档，将官方文档处理为适配 LLM 使用的 Markdown 格式，适用于 Cursor、Cline、Windsurf 等兼容 MCP 的 LLM 客户端。

⚠️ 强制要求：API 密钥

此 Skill 必须配置 API 密钥才能使用。

• 首次使用时，若 .env 中未定义 XBY_APIKEY，必须使用 AskUserQuestion 工具向用户询问 API 密钥
• 获取用户提供的密钥后，调用 scripts.config.set_api_key(api_key) 进行保存，然后继续执行后续流程
• 获取 API 密钥：https://xiaobenyang.com
• 禁止在缺少 API 密钥的情况下自行搜索或虚构任何数据

工作流程（必须遵守）

你（大模型）作为路由层，负责理解用户意图、选择合适工具、提取所需参数；所有实际代码逻辑仅用于调用 API。

用户输入 → 你选择工具 → 提取该工具所需的参数 → 调用 scripts.tools 中的函数 → 将结果返回给用户

步骤

1. 检查 API 密钥：若 scripts.config.settings.api_key 为空，需使用 AskUserQuestion 向用户询问密钥；获取后调用 scripts.config.set_api_key(key) 保存
2. 选择工具：根据用户意图，从下方工具列表中选择对应函数
3. 提取参数：依据所选工具，准确提取其必需的参数
4. 调用工具：使用关键字参数调用 scripts.tools 中的函数，例如：scripts.tools.search_schools(score='520', province='北京', category='综合')
5. 返回结果：将工具返回的 raw 数据整理后以清晰、易读的方式呈现给用户

工具选择规则

请根据用户意图选择对应的工具函数：

若参数不完整，必须使用 AskUserQuestion 向用户询问缺失参数。

工具函数说明

scripts.tools.list_docs

工具描述：列出所有可用的文档库与框架。这是探索可用文档集的第一步，返回每个文档集的名称、描述及源 URL。在使用其他文档类工具前必须先调用本工具，因为后续操作需要 docName。

参数定义

scripts.tools.search_docs

工具描述：在指定文档集中搜索特定内容。适用于查找包含关键词、概念或主题的页面。返回按相关性排序的匹配页面，含路径与简要描述。后续可调用 get_docs_page 获取完整内容。

参数定义

scripts.tools.get_docs_index

工具描述：获取文档集内所有页面的精简版、LLM 友好型索引。适用于初步探索，帮助理解文档覆盖范围并识别相关页面。返回一个 Markdown 格式的页面，其中包含所有可用页面的列表。后续可调用 get_docs_page 获取完整内容。

参数定义

scripts.tools.get_docs_page

工具描述：根据相对路径获取某篇具体文档页面的内容。适用于已通过 get_docs_index 或 search_docs 锁定目标页面后，进一步获取详细信息。返回单个文档页面的全部内容。

参数定义

scripts.tools.get_docs_full

工具描述：以单个整合文件形式获取整套文档的全部内容。适用于需要全面知识或需分析完整上下文的场景。返回大量文本——如仅需特定信息，请优先考虑 get_docs_page 或 search_docs。

参数定义

返回值处理

工具函数统一返回 dict 类型对象：

• result["raw"] —— API 原始响应数据（JSON 格式），请直接整理该字段内容并展示给用户
• result["success"] —— 执行是否成功（True/False）
• result["message"] —— 状态提示信息

项目结构

xiaobenyang_gaokao_skill/
├── scripts/
│   ├── __init__.py
│   ├── config.py       # 配置管理模块 + set_api_key()
│   ├── call_api.py      # API 客户端模块 + call_api()
│   └── tools.py         # 工具函数模块（直接封装并调用 API）
├── requirements.txt
└── SKILL.md

注意事项

1. API 密钥为必需项，无密钥时必须通过 AskUserQuestion 主动向用户索取
2. 禁止在缺少 API 密钥的情况下自行搜索或编造任何数据