使用 Gradio 文档 MCP 服务器

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

先决条件

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

为什么需要 MCP 服务器？

如果在你的工作流中使用 LLM，添加此服务器将为其提供恰到好处的 Gradio 上下文——这将使你的体验更快、更流畅。

该服务器运行在 Spaces 上，并完全使用 Gradio 启动，你可以在此处查看所有代码。有关使用 Gradio 构建 MCP 服务器的更多信息，请参阅上一指南。

在客户端安装

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

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

我们在下面提供了 Cursor 的分步说明，但你可以在此处查阅 Windsurf 的文档，并在此处查阅 Cline 的文档，它们的设置方式类似。

Cursor

1. 请确保你使用的是最新版本的 Cursor，并导航到 Cursor > Settings > Cursor Settings > MCP
2. 点击“+ 添加新的全局 MCP 服务器”
3. 将此 JSON 复制粘贴到打开的文件中，然后保存。

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

4. 就是这样！你应该会在设置页面看到工具加载，并且状态变为绿色。你可能需要点击刷新图标或等待几秒钟。

Claude Desktop

1. 由于 Claude Desktop 只支持标准输入输出 (stdio)，你需要安装 Node.js 才能使其工作。
2. 请确保你使用的是最新版本的 Claude Desktop，并导航到 Claude > Settings > Developer > Edit Config
3. 使用你喜欢的编辑器打开文件，复制粘贴此 JSON，然后保存文件。

{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gradio-docs-mcp.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}

4. 退出并重新打开 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 解析最有用的上下文。