介绍
# OpenAI Docs MCP Skill
## 概述
从 Shell 使用 OpenAI 开发者文档 MCP 服务器来搜索和获取权威文档。在进行 OpenAI 平台相关工作时，请务必执行此操作，而不是依赖记忆或非官方来源。
## 核心规则
- 对于 OpenAI API/SDK/Apps/Codex 问题，或者需要精确、最新的文档时，请始终使用此技能。 - 通过 `scripts/openai-docs-mcp.sh` 中的 CLI 封装器查询 MCP 服务器（不要依赖 Codex MCP 工具）。 - 使用 `search` 或 `list` 查找最佳文档页面，然后 `fetch` 该页面（或锚点）以获取确切文本。 - 在您的响应中提供您使用的文档 URL，以便明确来源。
## 快速开始
```bash scripts/openai-docs-mcp.sh search "Responses API" 5 scripts/openai-docs-mcp.sh fetch https://platform.openai.com/docs/guides/migrate-to-responses ```
## 工作流程
1. 发现：使用聚焦的查询进行 `search`。如果不确定，请使用 `list` 浏览。 2. 阅读：`fetch` 最相关的 URL（可选择添加锚点）。 3. 应用：总结和/或引用相关部分；包含 URL。
## 脚本参考
CLI 封装器位于 `scripts/openai-docs-mcp.sh`，并针对 `https://developers.openai.com/mcp` 使用 `curl` + `jq`。
子命令： - `init`：初始化并检查服务器功能。 - `tools`：列出 MCP 服务器上可用的工具。 - `search <query> [limit] [cursor]`：从文档索引返回 JSON 命中结果。 - `list [limit] [cursor]`：浏览文档索引。 - `fetch <url> [anchor]`：返回文档页面或章节的 markdown。 - `endpoints`：列出 OpenAPI 端点。 - `openapi <endpoint-url> [lang1,lang2] [code-only]`：获取 OpenAPI 模式或代码示例。
环境变量： - `MCP_URL`：覆盖默认的 MCP 端点。