快速入门

将 MCP 服务器视为为 Cline 提供额外能力的特殊助手！它们让 Cline 能够做一些很酷的事情，比如获取网页或处理您的文件。

🚀 MCP 快速入门指南

❓ 什么是 MCP 服务器？

将 MCP 服务器视为为 Cline 提供额外能力的特殊助手！它们让 Cline 能够做一些很酷的事情，比如获取网页或处理您的文件。

⚠️ 重要：系统要求

停止！在继续之前，您必须验证这些要求：

所需软件

✅ 最新版本的 Node.js（v18 或更新版本）
- 通过运行检查：node --version
- 从以下网址安装：https://nodejs.org/
✅ 最新版本的 Python（v3.8 或更新版本）
- 通过运行检查：python --version
- 从以下网址安装：https://python.org/
✅ UV 包管理器
- 安装 Python 后，运行：pip install uv
- 通过运行验证：uv --version

❗ 如果任何这些命令失败或显示旧版本，请在继续之前安装/更新！

⚠️ 如果遇到其他错误，请参阅下面的"故障排除"部分。

🎯 快速步骤（仅在满足要求后！）

1. 🛠️ 安装您的第一个 MCP 服务器

从 Cline 扩展中，点击 MCP Server 标签
点击 Edit MCP Settings 按钮

MCP 设置文件应显示在 VS Code 的标签页中。
将文件内容替换为此代码：

对于 Windows：


{
	"mcpServers": {
		"mcp-installer": {
			"command": "cmd.exe",
			"args": ["/c", "npx", "-y", "@anaisbetts/mcp-installer"]
		}
	}
}

对于 Mac 和 Linux：


{
	"mcpServers": {
		"mcp-installer": {
			"command": "npx",
			"args": ["@anaisbetts/mcp-installer"]
		}
	}
}

保存文件后：

Cline 会自动检测更改
MCP 安装程序将被下载并安装
Cline 将启动 MCP 安装程序
您将在 Cline 的 MCP 设置 UI 中看到服务器状态：

🤔 接下来做什么？

现在您已经安装了 MCP 安装程序，您可以要求 Cline 从以下位置添加更多服务器：

NPM 注册表：https://www.npmjs.com/search?q=%40modelcontextprotocol
Python 包索引：https://pypi.org/search/?q=mcp+server-&o=

例如，您可以要求 Cline 安装 Python 包索引中找到的 mcp-server-fetch 包：


"安装名为 `mcp-server-fetch` 的 MCP 服务器
- 确保更新了 mcp 设置。
- 使用 uvx 或 python 运行服务器。"

您应该会看到 Cline：

安装 mcp-server-fetch python 包
更新 mcp 设置 json 文件
启动服务器

mcp 设置文件现在应该如下所示：

对于 Windows 机器：


{
	"mcpServers": {
		"mcp-installer": {
			"command": "cmd.exe",
			"args": ["/c", "npx", "-y", "@anaisbetts/mcp-installer"]
		},
		"mcp-server-fetch": {
			"command": "uvx",
			"args": ["mcp-server-fetch"]
		}
	}
}

您始终可以通过转到客户端的 MCP 服务器标签来检查服务器的状态。参见上图

就是这样！🎉 您刚刚为 Cline 赋予了一些强大的新能力！

📝 故障排除

1. 我使用 `asdf` 并收到 “unknown command: npx”

有一些不太好的消息。您仍然应该能够让事情正常工作，但除非 MCP 服务器打包有所改进，否则您需要做更多的手动工作。一个选项是卸载 asdf，但我们假设您不想这样做。

相反，您需要按照上述说明"编辑 MCP 设置"。然后，如此帖子所述，您需要为每个服务器的配置添加一个 “env” 条目。


"env": {
        "PATH": "/Users/<user_name>/.asdf/shims:/usr/bin:/bin",
        "ASDF_DIR": "<path_to_asdf_bin_dir>",
        "ASDF_DATA_DIR": "/Users/<user_name>/.asdf",
        "ASDF_NODEJS_VERSION": "<your_node_version>"
      }

path_to_asdf_bin_dir 通常可以在您的 shell 配置（例如 .zshrc）中找到。如果您使用 Homebrew，可以使用 echo ${HOMEBREW_PREFIX} 找到目录的开头，然后附加 /opt/asdf/libexec。

现在有一些好消息。虽然不完美，但您可以相当可靠地让 Cline 为后续服务器安装执行此操作。将以下内容添加到 Cline 设置中的"自定义指令"中（右上角工具栏按钮）：

安装 MCP 服务器并编辑 cline_mcp_settings.json 时，如果服务器需要使用 npx 作为命令，您必须从 “mcp-installer” 条目复制 “env” 条目并将其添加到新条目中。这对于让服务器在使用时正常工作至关重要。

2. 运行 MCP 安装程序时仍然出错

如果运行 MCP 安装程序时仍然出错，您可以尝试以下操作：

检查 MCP 设置文件是否有错误
阅读 MCP 服务器的文档，确保 MCP 设置文件使用了正确的命令和参数。👈
使用终端直接运行命令及其参数。这将允许您看到 Cline 看到的相同错误。