FastGPT 集成 MCP 协议构建工具增强型智能体

一、MCP 协议简介

MCP 协议（Model Context Protocol）是由 Anthropic 在 2024 年 11 月初发布的一种协议，旨在统一 AI 模型与外部系统之间的通信方式，简化它们之间的交互问题。随着 OpenAI 官方宣布支持 MCP 协议，越来越多的 AI 厂商也开始支持这一协议。

MCP 协议主要包含 Client 和 Server 两部分：

Client（客户端）：使用 AI 模型的一方，通过 MCP Client 可以为模型提供调用外部系统的能力
Server（服务端）：提供外部系统调用的一方，实际运行外部系统的主体

FastGPT 从 v4.9.6 版本开始，新增了两种 MCP 相关的功能：

MCP 服务：可以将 FastGPT 应用以 MCP 协议对外提供
MCP 工具集：可以导入外部 MCP 服务，让 FastGPT 使用外部工具

mcp-proxy 是开源的 mcp 协议聚合代理，可以聚合多个 mcp 服务，并提供统一的 mcp 服务地址。

二、创建 MCP 工具集

1. 获取 MCP 服务地址

首先，您需要获取一个支持 MCP 协议的服务地址。这里以高德地图的 MCP 服务为例，访问高德地图 MCP Server 获取 MCP 地址，格式如：https://mcp.amap.com/sse?key=xxx。

2. 在 FastGPT 中创建 MCP 工具集

登录 FastGPT 平台
在弹出窗口中填入 MCP 服务地址
点击'解析'按钮，系统会自动解析出该 MCP 服务提供的一系列工具
点击'创建'按钮完成 MCP 工具集的创建

在工作台中选择'新建应用'，然后选择'MCP 工具集'

创建 MCP 工具集

三、测试 MCP 工具

创建完 MCP 工具集后，您可以对工具集中的单个工具进行测试：

进入 MCP 工具集详情页面
输入测试参数，如城市名称'杭州'
点击'运行'按钮，查看工具返回的结果
系统会显示该城市的具体天气信息

选择需要测试的具体工具，例如 maps_weather（天气查询工具）

测试 MCP 工具

四、AI 模型调用 MCP 工具

FastGPT 支持两种方式让 AI 模型调用 MCP 工具：

1. 调用单个工具

在工作流中添加'工具调用'节点
连接工作流节点，让 AI 模型能够调用这些工具

测试效果：分别提问天气和地点相关问题左图：AI 调用天气查询工具 | 右图：AI 调用地点搜索工具

天气查询结果

地点搜索结果

选择之前创建的特定 MCP 工具，例如选择 maps_weather 和 maps_text_search

调用单个工具

2. 调用整个工具集

FastGPT 还支持让 AI 自动选择合适的工具进行调用：

在工作流中添加'MCP 工具集'节点
此时 AI 会根据用户问题智能选择合适的工具，获取所需信息后回答问题

使用'工具调用'节点连接该工具集

工具集配置

调用效果

五、私有化部署支持

如果您使用的是 FastGPT 私有化部署版本，需要以下步骤来支持 MCP 功能：

1. 环境准备

确保您的 FastGPT 版本升级到 v4.9.6 或更高版本。

2. 修改 docker-compose.yml 文件

在 docker-compose.yml 文件中添加必要的环境变量以启用 MCP 相关功能，例如配置 MCP Server 的连接地址或启用相关开关。

3. 修改 FastGPT 配置

进入 FastGPT 配置文件（config.json 或 .env），确认 MCP 服务启用的参数已正确设置，确保允许外部工具调用。

4. 重启服务

执行 docker-compose down 后重新运行 docker-compose up -d 以应用更改，验证服务是否正常运行。

六、使用 MCP-Proxy 集成多个 MCP 服务

1. MCP-Proxy 简介

MCP-Proxy 用于聚合多个 MCP 服务，提供统一的 MCP 服务地址，简化接入流程。

2. 安装 MCP-Proxy

通过 npm 或 Docker 部署 MCP-Proxy 服务，确保网络可达。

3. 配置 MCP-Proxy

编辑配置文件，添加需要聚合的 MCP Server 地址列表，并设置相应的鉴权信息。

4. 将 MCP-Proxy 与 FastGPT 集成

在 FastGPT 中配置指向 MCP-Proxy 的地址即可调用所有聚合服务，无需逐个添加。

5. 高级配置

支持鉴权、限流等高级特性，根据实际需求调整代理策略以提升安全性。

七、最佳实践建议

定期更新 MCP 服务版本以确保兼容性
对敏感工具调用进行权限控制，防止未授权访问
监控 MCP 调用的延迟和错误率，优化响应速度

八、总结

通过 FastGPT 与 MCP 协议的结合，开发者可以快速构建具备外部工具调用能力的智能体，提升自动化水平。私有化部署方案进一步增强了数据安全性，配合 MCP-Proxy 可实现海量开源组件的快速接入。

FastGPT 集成 MCP 协议构建工具增强型智能体