Adding MCP Servers from GitHub

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

查找 MCP 服务器

有多个在线位置可以找到 MCP 服务器：

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

• GitHub：在 GitHub 上查找 MCP 服务器最常见的两个地方包括：

  • 官方 MCP 服务器仓库

  • Awesome-MCP 服务器仓库

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

  • mcpservers.org

  • mcp.so

  • glama.ai/mcp/servers

  • mcp.composio.dev

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

• PulseMCP：这个网站有一篇博客文章，讨论了 AI 如何可以使用 MCP 服务器使网站过时。PulseMCP 还包括关于 MCP 服务器的常见问题解答部分：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 检查器以测试服务器连接。之后，我们可以尝试从 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 检查器：你可以使用 MCP 检查器来测试服务器的连接和功能。

最佳实践

• 了解基础知识：虽然 Cline 简化了过程，但了解服务器代码、MCP 协议（了解更多）以及如何配置服务器的基本知识是有益的。这允许进行更有效的故障排除和自定义。

• 清晰的指令：在整个过程中向 Cline 提供清晰和具体的指令。

• 测试：在安装和配置后彻底测试服务器，以确保其正常运行。

• 版本控制：使用版本控制系统（如 Git）来跟踪对服务器代码的更改。

• 保持更新：保持你的 MCP 服务器更新，以受益于最新功能和安全补丁。