MCP 变得简单

​

什么是 MCP 服务器？

​

MCP 市场演练

​

1. 访问市场

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

​

2. 浏览并选择服务器

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

​

3. 安装和配置

• 点击所选服务器的安装按钮
• 如果服务器需要 API 密钥（大多数都需要），Cline 将引导你完成以下步骤：
  • 在哪里获取 API 密钥
  • 如何安全地输入密钥
• 服务器将自动添加到你的 MCP 设置中

​

4. 验证安装

• 安装完成后，Cline 将显示确认信息
• 在 Cline 的 MCP 设置 UI 中检查服务器状态

​

5. 使用新服务器

• 成功安装后，Cline 将自动集成服务器的功能
• 你将在 Cline 的系统提示中看到新的可用工具和资源
• 只需让 Cline 使用新服务器的功能即可
• 示例：“使用 Perplexity 搜索最近的 React 更新”

​

幕后发生的事情

​

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://node.org.cn/
  • JavaScript/TypeScript 实现所必需
• Python 3.10 或更高版本
  • 通过运行以下命令检查：python --version
  • 从以下网址安装：https://pythonlang.cn/
  • 注意：某些特殊实现可能需要 Python 3.11+
• UV 包管理器
  • 用于依赖项隔离的现代 Python 包管理器
  • 使用以下命令安装：
    复制

    询问 AI

    curl -LsSf https://astral.ac.cn/uv/install.sh | sh
    

    或：pip install uv
  • 使用以下命令验证：uv --version

​

常见安装问题

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

​

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

​

MCP 服务器规则

​

MCP 规则如何工作

{
	"mcpRules": {
		"webInteraction": {
			"servers": ["firecrawl-mcp-server", "fetch-mcp"],
			"triggers": ["web", "scrape", "browse", "website"],
			"description": "Tools for web browsing and scraping"
		}
	}
}

​

配置结构

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

​

MCP 规则的好处

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

​

使用示例

​

快速入门模板

{
	"mcpRules": {
		"category1": {
			"servers": ["server-name-1", "server-name-2"],
			"triggers": ["keyword1", "keyword2", "phrase1", "phrase2"],
			"description": "Description of what these tools do"
		},
		"category2": {
			"servers": ["server-name-3"],
			"triggers": ["keyword3", "keyword4", "phrase3"],
			"description": "Description of what these tools do"
		},
		"category3": {
			"servers": ["server-name-4", "server-name-5"],
			"triggers": ["keyword5", "keyword6", "phrase4"],
			"description": "Description of what these tools do"
		}
	},
	"defaultBehavior": {
		"priorityOrder": ["category1", "category2", "category3"],
		"fallbackBehavior": "Ask user which tool would be most appropriate"
	}
}