update mcp doc (#4572)

This commit is contained in:
Archer
2025-04-17 12:24:59 +08:00
committed by GitHub
parent 4fad9c6025
commit 853a75c9bc
146 changed files with 115 additions and 12 deletions

View File

@@ -21,10 +21,10 @@ weight: 831
## V4.6.5 功能介绍
1. 新增 - [问题优化模块](/docs/guide/workbench/workflow/coreferenceresolution/)
2. 新增 - [文本编辑模块](/docs/guide/workbench/workflow/text_editor/)
3. 新增 - [判断器模块](/docs/guide/workbench/workflow/tfswitch//)
4. 新增 - [自定义反馈模块](/docs/guide/workbench/workflow/custom_feedback/)
1. 新增 - [问题优化模块](/docs/guide/dashboard/workflow/coreferenceresolution/)
2. 新增 - [文本编辑模块](/docs/guide/dashboard/workflow/text_editor/)
3. 新增 - [判断器模块](/docs/guide/dashboard/workflow/tfswitch//)
4. 新增 - [自定义反馈模块](/docs/guide/dashboard/workflow/custom_feedback/)
5. 新增 - 【内容提取】模块支持选择模型,以及字段枚举
6. 优化 - docx读取兼容表格表格转markdown
7. 优化 - 高级编排连接线交互

View File

@@ -91,7 +91,7 @@ curl --location --request POST 'https://{{host}}/api/init/v468' \
1. 新增 - 知识库搜索合并模块。
2. 新增 - 新的 Http 模块,支持更加灵活的参数传入。同时支持了输入输出自动数据类型转化,例如:接口输出的 JSON 类型会自动转成字符串类型,直接给其他模块使用。此外,还补充了一些例子,可在文档中查看。
3. 优化 - 内容补全。将内容补全内置到【知识库搜索】中并实现了一次内容补全即可完成“指代消除”和“问题扩展”。FastGPT知识库搜索详细流程可查看[知识库搜索介绍](/docs/guide/workbench/workflow/dataset_search/)
3. 优化 - 内容补全。将内容补全内置到【知识库搜索】中并实现了一次内容补全即可完成“指代消除”和“问题扩展”。FastGPT知识库搜索详细流程可查看[知识库搜索介绍](/docs/guide/dashboard/workflow/dataset_search/)
4. 优化 - LLM 模型配置,不再区分对话、分类、提取模型。同时支持模型的默认参数,避免不同模型参数冲突,可通过`defaultConfig`传入默认的配置。
5. 优化 - 流响应,参考了`ChatNextWeb`的流,更加丝滑。此外,之前提到的乱码、中断,刷新后又正常了,可能会修复)
6. 修复 - 语音输入文件无法上传。

View File

@@ -1,5 +1,5 @@
---
weight: 202
weight: 225
title: '简易模式'
description: '快速了解 FastGPT 工作台的简易模式'
icon: 'speed'

View File

@@ -4,7 +4,7 @@ description: "FastGPT 使用 Gapier 快速导入Agent工具"
icon: "build"
draft: false
toc: true
weight: 300
weight: 280
---
FastGPT V4.7版本加入了工具调用,可以兼容 GPTs 的 Actions。这意味着你可以直接导入兼容 GPTs 的 Agent 工具。

View File

@@ -4,7 +4,7 @@ description: "快速了解 FastGPT 工作流和插件的使用"
icon: "extension"
draft: false
toc: true
weight: 220
weight: 226
---
FastGPT 从 V4 版本开始采用新的交互方式来构建 AI 应用。使用了 Flow 节点编排(工作流)的方式来实现复杂工作流,提高可玩性和扩展性。但同时也提高了上手的门槛,有一定开发背景的用户使用起来会比较容易。

View File

@@ -0,0 +1,103 @@
---
title: "MCP 服务"
description: "快速了解 FastGPT MCP server"
icon: "extension"
draft: false
toc: true
weight: 260
---
## MCP server 介绍
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
### 1. 创建 MCP server
登录 FastGPT 后,打开`工作台`,点击`MCP server`,即可进入管理页面,这里可以看到你创建的所有 MCP server以及他们管理的应用数量。
![创建 MCP server](/imgs/mcp_server1.png)
可以自定义 MCP server 名称和选择关联的应用
| | |
|---|---|
| ![](/imgs/mcp_server2.png) | ![](/imgs/mcp_server3.png) |
### 2. 获取 MCP server 地址
创建好 MCP server 后,可以直接点击`开始使用`,即可获取 MCP server 访问地址。
| | |
|---|---|
| ![](/imgs/mcp_server4.png) | ![](/imgs/mcp_server5.png) |
#### 3. 使用 MCP server
可以在支持 MCP 协议的客户端使用这些地址,来调用 FastGPT 应用,例如:`Cursor``Cherry Studio`。下面以 Cursor 为例,介绍如何使用 MCP server。
打开 Cursor 配置页面,点击 MCP 即可进入 MCP 配置页面,可以点击新建 MCP server 按钮,会跳转到一个 JSON 配置文件,将第二步的`接入脚本`复制到`json 文件`中,保存文件。
此时返回 Cursor 的 MCP 管理页面,即可看到你创建的 MCP server记得设成`enabled`状态。
| | | |
|---|---|---|
| ![](/imgs/mcp_server6.png) | ![](/imgs/mcp_server7.png) | ![](/imgs/mcp_server8.png) |
打开 Cursor 的对话框,切换成`Agent`模型只有这个模型cursor 才会调用 MCP server。
发送一个关于`fastgpt`的问题后可以看到cursor 调用了一个 MCP 工具(描述为:查询 fastgpt 知识库),也就是调用 FastGPT 应用去进行处理该问题,并返回了结果。
| | |
|---|---|
| ![](/imgs/mcp_server9.png) | ![](/imgs/mcp_server10.png) |
## 私有化部署 MCP server 问题
私有化部署版本的 FastGPT需要升级到`v4.9.6-alpha`及以上版本才可使用 MCP server 功能。
### 修改 docker-compose.yml 文件
`docker-compose.yml`文件中,加入`fastgpt-mcp-server`服务:
```yml
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 容器环境变量
修改`config.json`配置文件,增加: `"feconfigs.mcpServerProxyEndpoint": "fastgpt-mcp-server 的访问地址"` 末尾不要携带/,例如:
```json
{
"feConfigs": {
"lafEnv": "https://laf.dev",
"mcpServerProxyEndpoint": "https://mcp.fastgpt.cn"
}
}
```
### 重启 FastGPT 容器
因为是修改的挂载文件,可以强制 down 再 up 服务。启动后,既可以在工作台看到 MCP server 服务选项。
```bash
docker-compose down
docker-compose up -d
```