> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 从 GitHub 添加 MCP 服务器

本指南提供了如何使用 Cline 从 GitHub 仓库构建现有 MCP 服务器的逐步教程。

## **查找 MCP 服务器**

有多个在线地方可以找到 MCP 服务器：

* **Cline 可以自动将 MCP 服务器添加到其列表中，然后您可以编辑。** Cline 可以直接从 GitHub 克隆仓库并为您构建服务器。

* **GitHub：** 在 GitHub 上找到 MCP 服务器的两个最常见地方包括：
  * [官方 MCP 服务器仓库](https://github.com/modelcontextprotocol/servers)
  * [Awesome-MCP 服务器仓库](https://github.com/punkpeye/awesome-mcp-servers)

* **在线目录：** 几个网站列出了 MCP 服务器，包括：

  * [mcpservers.org](https://mcpservers.org/)
  * [mcp.so](https://mcp.so/)
  * [glama.ai/mcp/servers](https://glama.ai/mcp/servers)
  * [mcp.composio.dev](https://mcp.composio.dev/)

  这些目录允许用户按各种标准对服务器进行排序，如下载量、日期、星级和用例。每个条目提供功能、工具和配置说明等信息。

* **PulseMCP：** 这个网站有一篇关于 AI 如何使用 MCP 服务器使网站变得过时的博客文章。PulseMCP 还包含一个关于 MCP 服务器的常见问题部分：[https://www.pulsemcp.com/](https://www.pulsemcp.com/)

## **使用 Cline 构建**

1. **启动流程：** 向 Cline 提供以下信息：
   * **GitHub 仓库 URL：** 服务器仓库的 URL。
   * **README.md 内容：** 这是可选的，但有助于 Cline 理解服务器的用途和配置。您可以从 GitHub 仓库复制 README.md 文件。

2. **与 Cline 的示例交互：**

   ```
   用户："Cline，我想添加用于 Brave 浏览器控制的 MCP 服务器。这是 GitHub 链接：@https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search 你能添加它吗？"

   Cline："好的。正在将仓库克隆到 MCP 目录。它需要构建，因为它有 'package.json' 文件。我应该运行 'npm run build' 吗？"

   用户："是的，构建它。"

   Cline："构建完成。这个服务器需要一个浏览器路径。你的 Brave 浏览器可执行文件在哪里？"

   用户："在 '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser'。"

   Cline："好的。我已经用该路径更新了服务器配置，并将其添加到 'cline_mcp_settings.json'。还有其他的吗？"

   用户："没有了，就这些。我们来测试一下。"

   Cline："太好了！启动 MCP Inspector 来测试服务器连接。之后，我们可以尝试从 Cline 控制浏览器。"
   ```

3. **Cline 的操作：** 根据您的指令，Cline 将执行以下操作：
   * **仓库克隆：** Cline 将仓库克隆到您的本地机器，通常在您配置中指定的目录中。
   * **调整：** 您可以指导 Cline 修改服务器的配置。例如：
     * **用户：** "这个服务器需要一个 API 密钥。你能找到应该在哪里添加吗？"
     * Cline 可能会根据您的指令自动更新 `cline_mcp_settings.json` 文件或其他相关文件。
   * **构建服务器：** Cline 将为服务器运行适当的构建命令，通常是 `npm run build`。
   * **将服务器添加到设置：** Cline 将服务器的配置添加到 `cline_mcp_settings.json` 文件。

## **测试和故障排除**

1. **测试服务器：** 一旦 Cline 完成构建过程，测试服务器以确保它按预期工作。如果您遇到任何问题，Cline 可以协助您。
2. **MCP Inspector：** 您可以使用 MCP Inspector 来测试服务器的连接和功能。

## **最佳实践**

* **了解基础知识：** 虽然 Cline 简化了流程，但对服务器代码、MCP 协议（[了解更多](https://cat.mintlify.site/mcp/mcp-overview.md)）和如何配置服务器有基本了解是有益的。这允许更有效的故障排除和自定义。
* **明确的指令：** 在整个过程中向 Cline 提供明确和具体的指令。
* **测试：** 在安装和配置后彻底测试服务器以确保其正常运行。
* **版本控制：** 使用版本控制系统（如 Git）来跟踪服务器代码的更改。
* **保持更新：** 保持您的 MCP 服务器更新以受益于最新功能和安全补丁。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.