1. MCP
  2. 使用 Docs MCP

使用 Gradio 文档 MCP 服务器

在本指南中，我们将介绍如何使用官方的 Gradio 文档 MCP 服务器。

先决条件

您需要一个支持使用 MCP 协议进行工具调用的 LLM 应用程序，例如 Claude Desktop、Cursor 或 Cline（这些被称为“MCP 客户端”）。

为什么需要 MCP 服务器？

如果您在工作流程中使用 LLM，添加此服务器将为其提供有关 gradio 的恰当上下文，从而使您的体验更快、更顺畅。

该服务器在 Spaces 上运行，完全使用 Gradio 启动，您可以在这里查看所有代码。有关使用 gradio 构建 mcp 服务器的更多信息，请参阅上一份指南。

在客户端中安装

对于支持可流式 HTTP 的客户端（例如 Cursor、Windsurf、Cline），只需将以下配置添加到您的 MCP 配置中

{
  "mcpServers": {
    "gradio": {
      "url": "https://gradio-docs-mcp.hf.space/gradio_api/mcp/"
    }
  }
}

我们在下面提供了 Cursor 的分步说明，但您可以查阅 Windsurf 的文档这里和 Cline 的文档这里，设置方法类似。

Cursor

  1. 确保您使用的是最新版本的 Cursor，然后转到 Cursor > 设置 > Cursor 设置 > MCP
  2. 点击“+ 添加新的全局 MCP 服务器”
  3. 将此 json 复制粘贴到打开的文件中，然后保存。
{
  "mcpServers": {
    "gradio": {
      "url": "https://gradio-docs-mcp.hf.space/gradio_api/mcp/"
    }
  }
}
  1. 就是这样！您应该会看到工具加载并且设置页面中的状态变为绿色。您可能需要点击刷新图标或等待几秒钟。

Claude Desktop

  1. 由于 Claude Desktop 仅支持 stdio，您需要安装 Node.js 才能使其工作。
  2. 确保您使用的是最新版本的 Claude Desktop，然后转到 Claude > 设置 > 开发者 > 编辑配置
  3. 用您喜欢的编辑器打开文件，将此 json 复制粘贴进去，然后保存文件。
{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gradio-docs-mcp.hf.space/gradio_api/mcp/"
      ]
    }
  }
}
  1. 退出并重新打开 Claude Desktop，您就可以开始使用了。您应该会在“搜索和工具”图标中或开发者设置页面上看到它已加载。

工具

服务器中目前只有两个工具：gradio_docs_mcp_load_gradio_docs 和 gradio_docs_mcp_search_gradio_docs。

  1. gradio_docs_mcp_load_gradio_docs：此工具不带参数，将加载 Gradio 最新完整文档的 /llms.txt 格式摘要。在回答问题或生成代码之前，LLM 可以解析此非常有用上下文。

  2. gradio_docs_mcp_search_gradio_docs：此工具接受一个查询作为参数，并将在 Gradio 的文档、指南和演示上运行嵌入搜索，以返回对 LLM 解析最有用的上下文。

←

使用 Gradio 构建 MCP 客户端

使用 Gradio 构建 ChatGPT 应用

→
gradio