gud-api-mcp

Gud API

内置于编辑器中的轻量级全功能 API 客户端。测试 REST 和 GraphQL API，将请求整理到集合中，管理环境并生成代码片段，无需切换到 Postman 或其他外部工具。

从 Open VSX 或 VS Code Marketplace 安装。网站：gudapi.gudlab.org。

源码

编辑器扩展是专有软件。此仓库是产品文档和问题反馈的公开主页。它不包含 VS Code / Open VSX 扩展的源代码。

如果你是从 Marketplace 或 Open VSX 的链接来到 GitHub，那么你来对地方了，可以在这里反馈错误和功能请求。这里没有可供克隆的 UI 源码。

配套的 MCP 服务是公开的：@gudlab/gud-api-mcp，源码位于 gudlab/gud-api-mcp。文档：gudapi.gudlab.org/guide/ai-agents。

功能

请求构建器

• 支持所有 HTTP 方法：GET、POST、PUT、PATCH、DELETE、OPTIONS、HEAD
• 查询参数编辑器，支持 URL 双向同步和启用／停用开关
• 请求头编辑器，支持动态键值行
• 支持多种正文类型：JSON、表单 URL 编码、多部分表单数据、GraphQL、纯文本
• 通过多部分表单数据上传文件，并使用原生文件选择器
• 身份验证：Bearer Token、Basic Auth、API Key（请求头或查询参数）

GraphQL

• 专用 GraphQL 编辑器，包含独立的 Query 和 Variables 面板
• 自动将方法设为 POST，并将 Content-Type 设为 application/json
• 将变量解析为 JSON，并与查询一同发送

响应查看器

• 显示状态码、响应时间、大小和格式检测（JSON/HTML/XML）
• Pretty / Raw / Preview 切换 — Preview 会在沙盒 iframe 中渲染 HTML
• 搜索 — 在响应正文中查找文本，并显示匹配数量和导航选项
• Cookies 标签页 — 查看响应中的 Set-Cookie 请求头
• 复制按钮，可复制正文或请求头

代码生成

• 一键从任意请求生成代码
• 语言：cURL、JavaScript (fetch)、Python (requests)、Node.js (axios)
• 复制到剪贴板

请求历史记录

• 每个请求都会自动保存到历史记录中（最近 100 条）
• 在侧边栏中查看历史记录，包括方法、URL、状态和时间戳
• 点击任意条目即可将其重新载入请求构建器
• 在不同 VS Code 会话之间保留

Cookie 管理

• 自动捕获并存储响应中的 Cookie
• 后续请求会自动向匹配的域发送 Cookie
• 使用 Cookie 管理器按域查看、启用／停用和删除 Cookie
• 内存存储 — 重启 VS Code 后 Cookie 会重置

集合

• 将请求保存并整理到集合和文件夹中
• 点击即可将任意已保存的请求载入构建器
• 右键可重命名、删除或新建文件夹
• 支持深层嵌套的文件夹结构

导入

• Postman v2.x 集合（包括嵌套文件夹、请求头、正文和集合变量）
• Thunder Client 集合
• OpenAPI 3.x / Swagger 2.0 规范（路径会转换为请求，标签会转换为文件夹）
• 通过侧边栏按钮或命令面板导入

环境与变量

• URL、请求头和请求正文中支持 {{variable}} 语法 — 发送时自动解析
• 从 Postman 导入集合级变量（例如 {{base_url}}）
• 用户自定义环境，提供键值编辑器和启用／禁用开关
• 工具栏中的环境选择器 — 即时切换环境
• 变量解析顺序：环境变量优先于集合变量

编辑器集成

• 活动栏图标，便于快速访问
• 自动匹配 VS Code 主题（浅色、深色、高对比度）
• 无需打开工作区即可使用（数据存储在 VS Code 全局存储中）
• 键盘快捷键：按 Enter 发送请求

入门

1. 从 Open VSX 或 VS Code Marketplace 安装扩展
2. 点击活动栏中的 Gud API 图标
3. 输入 URL 并按 Send
4. 点击 Save 将请求添加到集合

要导入现有集合，请点击侧边栏中的 Import，然后选择 Postman、Thunder Client 或 OpenAPI JSON 文件。

面向 AI Agent 的 MCP

Agent 可通过 @gudlab/gud-api-mcp 创建、运行请求，并将其保存为真实的 Gud API 集合：

{
  "mcpServers": {
    "gud-api": {
      "command": "npx",
      "args": ["-y", "@gudlab/gud-api-mcp", "--project", "."]
    }
  }
}

源代码和工具：gudlab/gud-api-mcp。指南：gudapi.gudlab.org/guide/ai-agents。

免费版与 Pro 版

Gud API 可免费使用，请求、集合或文件夹数量均不受限制。团队／云同步是 Pro 版的付费升级功能。

功能	免费版	Pro 版
无限请求	是	是
集合与文件夹	是	是
导入（Postman、Thunder Client、OpenAPI）	是	是
身份验证（Bearer、Basic、API Key）	是	是
支持 GraphQL	是	是
Multipart 表单数据与文件上传	是	是
代码生成（cURL、fetch、Python、axios）	是	是
请求历史记录	是	是
Cookie 管理	是	是
响应搜索与格式切换	是	是
集合变量	是	是
环境	1 个	不限
团队同步	-	是
云端集合	-	是

Pro：每月 $4，或终身版 $29。

支持

Gud API 免费使用且没有限制。如果它为你节省了时间，欢迎考虑支持开发工作：

• 请我喝杯咖啡
• PayPal

反馈与问题

请在 github.com/gudlab/gud-api/issues 报告错误或请求新功能。

许可证

专有软件。详见 LICENSE。编辑器 UI 不开源。MCP 服务在 gudlab/gud-api-mcp 中拥有自己的许可证。