用途：apifable 是一个 MCP 服务器，目标是让 AI 智能体更顺畅地把 API 集成进 TypeScript 前端项目。它向 AI 提供准确的 API 上下文，帮助写出正确的集成代码。
主要能力：
- 支持 OpenAPI 3.0 / 3.1 规范作为可靠事实来源。
- 作为 MCP 服务器接入 Claude、Cursor、Windsurf 等 AI 智能体。
- API 探索：浏览端点、按关键词搜索、查看完整请求/响应细节。
- 生成可直接用于前端代码的 TypeScript 类型定义。
使用方式：
- 运行 apifable init 初始化项目配置，会在项目根目录生成 apifable.config.json，建议提交到版本控制以共享 spec 路径。
- 初始化时可选择 Manual file（规范已在项目中，手动放置并维护更新）或 Remote URL（从稳定远程地址下载，支持 yaml 与 json；该模式会自动把本地下载路径加入 .gitignore）。
- 远程模式可用命令把 spec.url 下载到 spec.path；规范变更时重新运行即可刷新。
- 团队成员可共享的非敏感请求头放在 apifable.config.json 的 spec.headers；需要认证的私密请求头放在 .apifable/auth.json，不应提交到版本控制。两个文件的请求头值都支持 ${ENV_VAR} 语法。
- 在 .mcp.json 中添加配置即可接入；Cursor、Windsurf 等其他智能体可用相同方式配置。
MCP 工具：get_api_overview 返回标题、版本、描述、servers 及各 tag 的端点数量；list_endpoints_by_tag 按 tag 分页返回端点；search_endpoints 在 operationId、path、summary、description 中做关键词搜索，无精确匹配时回退模糊搜索并返回 matchType/score；get_endpoint 按 method+path 或 operationId 返回含参数的完整端点并解析内部 $ref；search_schemas 搜索 schema 名称与描述；get_schema 返回完整 schema；generate_types 以 schemas、method+path 或 operationId 之一生成自包含的 TypeScript 声明（含传递依赖、不含 import 语句）。
限制：每次调用只能使用一种 generate_types 模式，不可混用；不支持外部 $ref（其他文件或 URL），不支持 OpenAPI 2.0（Swagger），仅支持 3.0 与 3.1。
