手把手教你入门 MCP:模型上下文协议与 Trae IDE 中的实践
✨点击上方关注☝️,追踪不迷路!
一、什么是 MCP?
MCP(Model Context Protocol)是一种开放协议,它标准化了应用程序如何向大型语言模型(LLMs)提供上下文。可以将 MCP 想象成 AI 应用程序的 USB-C 接口——正如 USB-C 提供了标准化的方式来连接设备与各种外设和配件一样,MCP 提供了标准化的方式来连接 AI 模型与不同的数据源和工具。
MCP 使你能够在 LLM 之上构建代理和复杂工作流,并将你的模型与外部世界连接起来。它提供了一套标准规则,让 AI 模型能够理解如何获取上下文信息、如何与外部工具交互,以及如何处理和利用返回的结果。
二、为什么要学习 MCP?
MCP 为 AI 生态系统带来了许多重要价值:
- 丰富的预构建集成:MCP 提供了一系列预构建的集成,你的 LLM 可以直接接入使用
- 标准化的自定义集成方式:为 AI 应用程序提供了标准化的方式来构建自定义集成
- 开放的协议:每个人都可以自由实现和使用 MCP 协议
- 灵活性:允许在不同应用之间切换并携带你的上下文
对于开发者和 AI 用户来说,学习 MCP 意味着你可以充分利用 AI 模型与外部工具的协同能力,构建更加强大和实用的 AI 应用。
三、MCP 的基本工作原理
MCP 协议的核心工作原理是建立 AI 模型与外部数据源、工具之间的标准化通信桥梁。以下是 MCP 的基本工作流程:
- 上下文获取:MCP 服务从各种数据源收集上下文信息
- 标准化处理:将上下文信息转换为标准格式
- 模型交互:将标准化的上下文传递给 AI 模型
- 工具调用:根据模型需求,通过 MCP 协议调用外部工具
- 结果返回:将工具执行结果格式化后返回给模型
在 Trae IDE 这样的开发环境中,AI 助手正是通过 MCP 协议来调用代码搜索、文件编辑、命令执行等各种功能,从而更好地理解代码库上下文,为开发者提供更精准的帮助。
四、如何在 Trae IDE 中配置 Gitee MCP 服务
Gitee 提供了 MCP 服务,允许 Trae IDE 通过 MCP 协议与 Gitee 平台进行交互。下面是在 Trae 中配置 Gitee MCP 服务的步骤:
1. 获取 Gitee 访问令牌
首先,你需要在 Gitee 上创建一个访问令牌,用于 Trae IDE 与 Gitee MCP 服务之间的身份验证:
- 登录你的 Gitee 账号
- 进入「设置」→「安全设置」→「私人令牌」
- 点击「生成新令牌」,选择需要的权限(如
repo
、user_info
等) - 保存生成的令牌,这将用于后续配置
2. 在 Trae IDE 中配置 Gitee MCP 服务
在 Trae IDE 中,你可以通过以下 JSON 配置来连接 Gitee MCP 服务:
{
"mcpServers": {
"gitee": {
"url": "https://api.gitee.com/mcp",
"headers": {
"Authorization": "Bearer <私人令牌>"
}
}
}
}
其中,<私人令牌>
是你在第一步中获取的 Gitee 访问令牌。你可以将此配置添加到 Trae IDE 的 MCP 服务配置文件中。
3. 测试 Gitee MCP 服务连接
在 Trae IDE 中测试 Gitee MCP 服务连接的实际操作步骤如下:
- 打开 Trae IDE 的 MCP 服务配置面板
- 选择你刚刚配置的 Gitee MCP 服务
- 点击服务配置旁边的「开启连接」按钮
- Trae IDE 会自动向 Gitee MCP 服务发送一个简单的请求来验证连接是否正常
- 观察测试结果:如果连接成功,你会看到服务会有一个绿色勾,并可能显示一些基本的用户信息摘要;如果连接失败,会有红色感叹号,点击会显示具体的错误信息
通过这种方式,你可以确认 Gitee MCP 服务配置是否正确,以及能否正常与 Gitee 平台通信。
4. 开始使用
在trae对话中输入@切换到对应的builder with MCP 智能体,并输入“帮我查询我的 gitee 有多少个仓库?” 如下图
五、在 Trae IDE 中配置 MCP 服务
在 Trae IDE 中,你可以通过两种方式添加和配置 MCP 服务:从市场添加或手动添加。下面将详细介绍这两种配置方法。
5.1 从市场添加 MCP 服务
Trae IDE 提供了 MCP 市场,其中包含了社区中热门的 MCP 服务,你可以直接从中选择并添加:
操作步骤:
- 在 AI 侧边对话框的右上角,点击「设置」图标
- 选择「MCP」页签
- 点击「+ 添加 MCP Servers」按钮;或点击右上角的「+ 添加」按钮,然后在菜单中选择「从市场添加」
- 在打开的 MCP 市场中,浏览并找到你需要的 MCP 服务
- 点击该服务右侧的「+」按钮
- 在弹出的配置窗口中,填写必要的配置信息
注意事项:
- 对于标记为「Local」的 MCP 服务,需要在本地安装 NPX 或 UVX 后才能使用
- 配置内容中的环境变量信息(如 API Key、Token、Access Key 等字段)须替换为你的真实信息
- 填写完成后,点击「确认」按钮保存配置
5.2 手动添加 MCP 服务
如果你需要添加的 MCP 服务不在市场中,或者你想使用自己开发的 MCP 服务,可以通过手动添加的方式:
操作步骤:
- 在 AI 侧边对话框的右上角,点击「设置」图标,然后在菜单中选择「MCP」
- 进入 MCP 配置界面后,点击右上角的「+ 添加」按钮,然后在菜单中选择「手动添加」
- 在弹出的「手动配置」窗口中,填写 MCP 服务的详细配置
配置建议:
- 优先使用 NPX 或 UVX 配置方式
- 如果你希望添加一个全新的 MCP 服务,可以参考 MCP 官方文档中的协议规范
- 配置完成后,点击「确认」按钮保存设置
5.3 配置系统环境
为确保 MCP 服务能够正常启动和运行,你可能需要安装以下工具:
5.3.1 安装 Node.js
NPX 工具依赖于 Node.js 环境(版本需大于等于 18):
- 前往 Node.js 官网,下载并安装 Node.js 18 或更高版本
- 安装完成后,在终端中运行以下命令确认安装成功:
node -v npx -v
- 若安装成功,终端会输出相应的版本号
- 重启 Trae IDE,使 Node.js 环境生效
5.3.2 安装 uvx(Python 工具)
uvx 是基于 Python 的快速执行工具,用于运行 Python 脚本的 MCP 服务:
- 前往 Python 官网,下载并安装 Python 3.8 或更高版本
- 安装完成后,在终端中运行以下命令确认安装成功:
python --version
- 执行以下命令安装 uv(包含 uvx):
- macOS / Linux 系统:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Windows 系统(PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
- macOS / Linux 系统:
- 安装完成后,运行以下命令验证:
uvx --version
5.3.3 安装 Docker(可选)
如果你需要使用 GitHub MCP Server,则需要安装 Docker:
macOS 系统:
- 手动安装:前往 Docker 官方网站,下载适用于 macOS 的 Docker Desktop 安装包(.dmg 文件)
- 使用 Homebrew 安装:
brew install --cask docker
Windows 系统:
- 前往 Docker 官方网站,下载并安装 Docker Desktop,确保勾选「Use the WSL 2 based engine」选项
验证安装:
docker --version
docker info
5.4 MCP 服务传输类型
在 Trae IDE 中,MCP Server 支持三种传输类型:
- stdio 传输:通过标准输入/输出进行通信,适用于本地运行的 MCP 服务
- SSE 传输:Server-Sent Events 传输,支持服务端向客户端推送事件
- Streamable HTTP 传输:支持流式 HTTP 通信的传输方式
根据你选择的 MCP 服务类型,Trae IDE 会自动选择合适的传输方式。
六、MCP 开发资源
如果你想深入了解 MCP 协议或开发自己的 MCP 服务,可以参考以下资源:
- 官方 SDK:MCP 提供了多种语言的官方 SDK,包括 Python、JavaScript、Java 等,这些 SDK 处理了协议细节,让你可以专注于构建功能
- 协议规范文档:详细说明了 MCP 协议的请求和响应格式、数据类型等技术细节
- 示例代码库:包含了各种 MCP 服务和客户端的示例实现
- 社区论坛:可以与其他开发者交流 MCP 开发经验和问题
七、总结
MCP(模型上下文协议)是连接 AI 模型与外部世界的重要桥梁,它通过标准化的方式,让 AI 模型能够获取上下文信息并调用各种外部工具。在 Trae IDE 中,AI 助手正是通过 MCP 协议来提供代码搜索、文件编辑、命令执行等强大功能。
通过本文的介绍,你应该已经了解了 MCP 的基本概念、工作原理以及在 Trae IDE 中配置和使用 Gitee MCP 服务的方法。随着 AI 技术的不断发展,MCP 协议的重要性将会越来越凸显,它将为 AI 应用提供更广阔的可能性。
如果你想进一步学习 MCP,可以访问官方文档或加入 MCP 社区,与其他开发者一起探索 MCP 的更多可能性。
延伸阅读:
最后,创作不易请允许我插播一则自己开发的小程序广告,感兴趣可以访问体验:
【「合图图」产品介绍】
-
主要功能为:本地添加相册图片进行无限长图高清拼接,各种布局拼接等
-
安全:无后台服务无需登录,全程设备本地运行,隐私100%安全;
-
高效:自由布局+实时预览,效果所见即所得;
-
高清:秒生高清拼图,一键保存相册。
-
立即体验 →合图图 或微信小程序搜索「合图图」
如果觉得本文有用,欢迎点个赞👍和收藏⭐支持我吧!