> ## 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.

# MCP 变得简单

> 学习如何使用 MCP Marketplace 来发现、安装和配置增强 Cline 功能的 MCP 服务器，提供额外的工具和资源。

## 什么是 MCP 服务器？

MCP 服务器是增强 Cline 功能的专用扩展。它们使 Cline 能够执行额外的任务，如获取网页、处理图像、访问 API 等等。

## MCP Marketplace 演练

MCP Marketplace 为数百个不同类别的 MCP 服务器提供一键安装体验。

### 1. 访问 Marketplace

* 在 Cline 中，点击顶部工具栏中的 "扩展" 按钮（方形图标）
* MCP marketplace 将打开，按类别显示可用的服务器

### 2. 浏览和选择服务器

* 按类别浏览服务器（搜索、文件系统、浏览器自动化、研究数据等）
* 点击服务器查看其功能和要求的详细信息

### 3. 安装和配置

* 点击您选择的服务器的安装按钮
* 如果服务器需要 API 密钥（大多数需要），Cline 将指导您完成：
  * 在哪里获取 API 密钥
  * 如何安全地输入它
* 服务器将自动添加到您的 MCP 设置中

### 4. 验证安装

* 安装完成时 Cline 将显示确认
* 在 Cline 的 MCP 设置 UI 中检查服务器状态

### 5. 使用您的新服务器

* 成功安装后，Cline 将自动集成服务器的功能
* 您将在 Cline 的系统提示中看到新的工具和资源
* 只需要求 Cline 使用您新服务器的功能
* 示例："使用 Perplexity 搜索最近的 React 更新"

**企业用户：** 如果您在企业环境中使用 Cline，请确保根据您组织的安全策略获得安装第三方 MCP 服务器的许可。

## 幕后发生的事情

当您安装 MCP 服务器时，会自动发生几件事：

### 1. 安装过程

* 服务器代码被克隆/安装到 `/Users/<username>/Documents/Cline/MCP/`
* 安装依赖项
* 构建服务器（TypeScript/JavaScript 编译或 Python 包安装）

### 2. 配置

* MCP 设置文件使用您的服务器配置进行更新
* 此文件位于：`/Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
* 环境变量（如 API 密钥）被安全存储
* 注册服务器路径

### 3. 服务器启动

* Cline 检测配置更改
* Cline 将您的服务器作为单独进程启动
* 通过 stdio 或 HTTP 建立通信

### 4. 与 Cline 集成

* 您服务器的功能被添加到 Cline 的系统提示中
* 工具通过 `use_mcp_tool` 命令变得可用
* 资源通过 `access_mcp_resource` 命令变得可用
* Cline 现在可以在用户提示时使用这些功能

## 故障排除

### 系统要求

确保您的系统满足这些要求：

* **Node.js 18.x 或更新版本**
  * 通过运行检查：`node --version`
  * 从以下位置安装：[https://nodejs.org/](https://nodejs.org/)
  * JavaScript/TypeScript 实现所需
* **Python 3.10 或更新版本**
  * 通过运行检查：`python --version`
  * 从以下位置安装：[https://python.org/](https://python.org/)
  * 注意：某些专用实现可能需要 Python 3.11+
* **UV 包管理器**
  * 用于依赖项隔离的现代 Python 包管理器
  * 使用以下方式安装：
    ```bash
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```
    或：`pip install uv`
  * 使用以下方式验证：`uv --version`

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

### 常见安装问题

* 确保您的互联网连接稳定
* 检查您是否有安装新软件的必要权限
* 验证 API 密钥是否正确输入（如果需要）
* 在 MCP 设置 UI 中检查服务器状态是否有任何错误消息

### 如何删除 MCP 服务器

要完全删除有问题的 MCP 服务器：

1. 打开 MCP 设置文件：`/Users/<username>/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
2. 从 `mcpServers` 对象中删除您服务器的整个条目
3. 保存文件
4. 重启 Cline

### 我仍然遇到错误

如果您在使用 MCP 服务器时遇到错误，可以尝试以下操作：

* 检查 MCP 设置文件是否有错误
* 使用 Claude Sonnet 模型进行安装
* 验证到您服务器文件的路径是否正确
* 确保设置了所有必需的环境变量
* 检查是否有其他进程使用相同端口（对于基于 HTTP 的服务器）
* 尝试删除并重新安装服务器（从 `cline_mcp_settings.json` 文件和 `/Users/<username>/Documents/Cline/MCP/` 目录中删除）
* 使用终端直接使用其参数运行命令。这将允许您看到 Cline 看到的相同错误

## MCP 服务器规则

Cline 已经知道您的活动 MCP 服务器及其用途，但当您启用了很多 MCP 服务器时，定义何时使用每个服务器可能很有用。

利用 `.clinerules` 文件或自定义指令来支持通过基于关键字的触发器智能激活 MCP 服务器，使 Cline 的工具选择更直观和上下文感知。

### MCP 规则如何工作

MCP 规则将您连接的 MCP 服务器分组为功能类别，并定义在与 Cline 的对话中检测到时自动激活它们的触发关键字。

```json
{
	"mcpRules": {
		"webInteraction": {
			"servers": ["firecrawl-mcp-server", "fetch-mcp"],
			"triggers": ["web", "scrape", "browse", "website"],
			"description": "用于网络浏览和抓取的工具"
		}
	}
}
```

### 配置结构

1. **类别**：分组相关服务器（例如，"webInteraction"、"mediaAndDesign"）
2. **服务器**：每个类别中的服务器名称列表
3. **触发器**：激活这些服务器的关键字
4. **描述**：人类可读的类别解释

### MCP 规则的好处

* **上下文工具选择**：Cline 根据对话上下文选择适当的工具
* **减少摩擦**：无需手动指定使用哪个工具
* **有组织的功能**：逻辑上分组相关工具和服务器
* **优先级**：通过明确的优先级排序处理模糊情况

### 示例用法

当您写 "你能抓取这个网站吗？" 时，Cline 检测到 "scrape" 和 "website" 作为触发器，自动选择与网络相关的 MCP 服务器。

对于像 "苹果的股价是多少？" 这样的金融任务，像 "stock" 和 "price" 这样的关键字会触发与金融相关的服务器。

### 快速开始模板

```json
{
	"mcpRules": {
		"category1": {
			"servers": ["server-name-1", "server-name-2"],
			"triggers": ["keyword1", "keyword2", "phrase1", "phrase2"],
			"description": "这些工具的功能描述"
		},
		"category2": {
			"servers": ["server-name-3"],
			"triggers": ["keyword3", "keyword4", "phrase3"],
			"description": "这些工具的功能描述"
		},
		"category3": {
			"servers": ["server-name-4", "server-name-5"],
			"triggers": ["keyword5", "keyword6", "phrase4"],
			"description": "这些工具的功能描述"
		}
	},
	"defaultBehavior": {
		"priorityOrder": ["category1", "category2", "category3"],
		"fallbackBehavior": "询问用户哪个工具最合适"
	}
}
```

将此添加到您的 `.clinerules` 文件或自定义指令中，使 Cline 的 MCP 服务器选择更直观和上下文感知。


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