跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
TypeScriptNode.jsSaaSAI

基于 FastGPT 与 MCP 协议构建工具增强型 AI Agent

FastGPT 集成 MCP 协议实现工具增强型智能体构建指南。介绍 MCP 协议原理，演示如何在 FastGPT 中创建和测试 MCP 工具集，支持 AI 模型调用单个工具或整个工具集。针对私有化部署场景，提供环境准备、Docker 配置及 MCP-Proxy 聚合方案，帮助开发者将海量开源 MCP 组件快速接入平台，提升智能体应用的集成能力。

林间仙子发布于 2026/2/6更新于 2026/7/208.6K 浏览
基于 FastGPT 与 MCP 协议构建工具增强型 AI Agent

基于 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 相关的功能：

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

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

本文将重点介绍如何在 FastGPT 中集成和使用 MCP 工具集。另外，对于私有化部署的 fastgpt，本文给出了 mcp 服务聚合的解决方案。从而实现海量的开源 mcp 组件能够快速接入 Fastgpt 平台，为平台上的智能体应用提供丰富的集成能力。

二、创建 MCP 工具集

1. 获取 MCP 服务地址

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

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

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

创建 MCP 工具集

三、测试 MCP 工具

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

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

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

测试 MCP 工具

四、AI 模型调用 MCP 工具

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

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

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

    天气查询结果

    地点搜索结果

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

    调用单个工具

    2. 调用整个工具集

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

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

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

    工具集配置

    调用效果

    五、私有化部署支持

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

    1. 环境准备

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

    2. 修改 docker-compose.yml 文件

    在 docker-compose.yml 文件中添加 MCP 相关的环境变量配置。通常需要在 FastGPT 服务容器中添加 MCP_PROXY_URL 环境变量，指向本地运行的 MCP-Proxy 地址。同时确保网络配置允许容器间通信。

    services:
  fastgpt:
    environment:
      - MCP_PROXY_URL=http://mcp-proxy:3000
    3. 修改 FastGPT 配置

    在 .env 文件中确认 MCP 功能已启用，设置 NEXT_PUBLIC_MCP_ENABLED=true。如果使用了自定义域名，需确保 SSL 证书配置正确，因为部分 MCP 服务要求 HTTPS 连接。

    4. 重启服务

    执行以下命令重启 Docker 容器以应用新配置：

    docker-compose down
docker-compose up -d

    验证服务是否启动成功，并检查日志中是否有 MCP 初始化相关的报错信息。

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

    1. MCP-Proxy 简介

    MCP-Proxy 是一个开源的 MCP 协议聚合代理，用于将多个分散的 MCP Server 聚合成一个统一的 MCP 服务地址。这解决了在 FastGPT 中直接管理大量独立 MCP 服务的复杂性。

    2. 安装 MCP-Proxy

    可以通过 Docker 快速部署 MCP-Proxy。拉取官方镜像并运行容器：

    docker run -d --name mcp-proxy -p 3000:3000 ghcr.io/modelcontextprotocol/mcp-proxy
    3. 配置 MCP-Proxy

    创建 config.yaml 文件定义要聚合的 MCP 服务列表。每个服务需指定名称、类型及连接地址。

    servers:
  - name: amap_weather
    type: sse
    url: https://mcp.amap.com/sse?key=xxx
  - name: local_tool
    type: stdio
    command: node
    args: ["./tools/index.js"]
    4. 将 MCP-Proxy 与 FastGPT 集成

    在 FastGPT 的 MCP 工具集配置中，填入 MCP-Proxy 的地址，例如 http://localhost:3000。FastGPT 将通过此代理访问所有注册的 MCP 服务。

    5. 高级配置

    支持配置鉴权中间件、请求限流策略以及日志记录。在生产环境中建议开启认证机制，防止未授权访问。

    七、最佳实践建议

    1. 安全性：确保 MCP 服务地址仅在内网可访问，避免暴露敏感接口。
    2. 监控：定期检查 MCP 服务的响应延迟和错误率，及时排查异常。
    3. 版本管理：关注 MCP 协议更新，保持 FastGPT 与 MCP 服务的兼容性。
    4. 资源隔离：为不同的业务场景分配独立的 MCP 服务实例，避免相互干扰。

    八、总结

    本文详细介绍了如何在 FastGPT 中集成和使用 MCP 工具集，实现了 AI 模型对第三方工具的灵活调用。通过 MCP-Proxy 方案，有效解决了私有化部署下的多服务聚合问题。开发者可根据实际需求选择合适的 MCP 服务，构建功能更强大的智能体应用。

    目录

    1. 基于 FastGPT 与 MCP 协议实现工具增强型智能体构建
    2. 一、MCP 协议简介
    3. 二、创建 MCP 工具集
    4. 1. 获取 MCP 服务地址
    5. 2. 在 FastGPT 中创建 MCP 工具集
    6. 三、测试 MCP 工具
    7. 四、AI 模型调用 MCP 工具
    8. 1. 调用单个工具
    9. 2. 调用整个工具集
    10. 五、私有化部署支持
    11. 1. 环境准备
    12. 2. 修改 docker-compose.yml 文件
    13. 3. 修改 FastGPT 配置
    14. 4. 重启服务
    15. 六、使用 MCP-Proxy 集成多个 MCP 服务
    16. 1. MCP-Proxy 简介
    17. 2. 安装 MCP-Proxy
    18. 3. 配置 MCP-Proxy
    19. 4. 将 MCP-Proxy 与 FastGPT 集成
    20. 5. 高级配置
    21. 七、最佳实践建议
    22. 八、总结
    • 免费图片AI生成工具免费生成了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
    • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
    • 100+免费在线小游戏爽一把
    极客日志微信公众号二维码

    微信扫一扫，关注极客日志

    微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • Apache IoTDB 集群安装部署指南与技术优势分析
    • 基于 7 系列 FPGA 实现万兆以太网通信
    • Windows 电脑本地搭建 Llama-3-8B 个人知识问答助手
    • OmniInsert：借助扩散变换器实现任意对象无掩码视频插入
    • 详解数据结构之跳表
    • Python 实现 MCP 客户端调用高德地图天气查询示例
    • Python 实现 MCP 客户端调用高德地图天气查询示例
    • 基于 Isaac Lab 的机器人行走训练教程
    • Python 调用高德地图 MCP 服务查询天气示例
    • 10 个 GitHub 热门开源项目：AI Agent、Rust 架构与开发者工具
    • AI编程工具深度对比：Cursor、Copilot、Trae与Claude Code，2025年开发者该如何选择？
    • 基于 Python 的广东旅游数据分析系统设计与实现
    • LangChain 核心解析：从 LLM 调用到 Agent 架构
    • 龙虾机器人（OpenClaw）本地部署完全技术指南
    • OpenArm 开源机械臂教程：构建智能协作机器人
    • 15 个提示词技巧降低 AIGC 检测率，提升文本自然度
    • Linux C++ 多进程编程：fork 函数与进程管理机制
    • 从空乘转行网络安全：零基础入门经验与面试技巧分享
    • 拆解 CASIC MOTOR 14.8V 无刷减速电机及机器人底盘应用
    • DeepMind 创始人：AI 已成为科学发现的分水岭

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

    • 随机西班牙地址生成器

      随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

    • Markdown转HTML

      将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online