MCP 服务

MCP server 介绍 link

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

MCP 协议主要包含 Client 和 Server 两部分。简单来说，Client 是使用 AI 模型的一方，它通过 MCP Client 可以给模型提供一些调用外部系统的能能力；Server 是提供外部系统调用的一方，也就是实际运行外部系统的一方。

FastGPT MCP Server 功能允许你选择多个在 FastGPT 上构建好的应用，以 MCP 协议对外提供调用 FastGPT 应用的能力。

目前 FastGPT 提供的 MCP server 为 SSE 通信协议，未来将会替换成 HTTP streamable。

FastGPT 使用 MCP server link

1. 创建 MCP server link

登录 FastGPT 后，打开工作台，点击MCP server，即可进入管理页面，这里可以看到你创建的所有 MCP server，以及他们管理的应用数量。

可以自定义 MCP server 名称和选择关联的应用

2. 获取 MCP server 地址 link

创建好 MCP server 后，可以直接点击开始使用，即可获取 MCP server 访问地址。

3. 使用 MCP server link

可以在支持 MCP 协议的客户端使用这些地址，来调用 FastGPT 应用，例如：Cursor、Cherry Studio。下面以 Cursor 为例，介绍如何使用 MCP server。

打开 Cursor 配置页面，点击 MCP 即可进入 MCP 配置页面，可以点击新建 MCP server 按钮，会跳转到一个 JSON 配置文件，将第二步的接入脚本复制到json 文件中，保存文件。

此时返回 Cursor 的 MCP 管理页面，即可看到你创建的 MCP server，记得设成enabled状态。

打开 Cursor 的对话框，切换成Agent模型，只有这个模型，cursor 才会调用 MCP server。
发送一个关于fastgpt的问题后，可以看到，cursor 调用了一个 MCP 工具（描述为：查询 fastgpt 知识库），也就是调用 FastGPT 应用去进行处理该问题，并返回了结果。

私有化部署 MCP server 问题 link

私有化部署版本的 FastGPT，需要升级到v4.9.6-alpha及以上版本才可使用 MCP server 功能。

修改 docker-compose.yml 文件 link

在docker-compose.yml文件中，加入fastgpt-mcp-server服务:

  fastgpt-mcp-server:
    container_name: fastgpt-mcp-server
    image: ghcr.io/labring/fastgpt-mcp_server:latest
    ports:
      - 3005:3000
    networks:
      - fastgpt
    restart: always
    environment:
      - FASTGPT_ENDPOINT=http://fastgpt:3000
  

修改 FastGPT 容器环境变量 link

修改config.json配置文件，增加: "feconfigs.mcpServerProxyEndpoint": "fastgpt-mcp-server 的访问地址"， 末尾不要携带/，例如:

  {
  "feConfigs": {
    "lafEnv": "https://laf.dev",
    "mcpServerProxyEndpoint": "https://mcp.fastgpt.cn" 
  }
}
  

重启 FastGPT 容器 link

因为是修改的挂载文件，可以强制 down 再 up 服务。启动后，既可以在工作台看到 MCP server 服务选项。

  docker-compose down
docker-compose up -d