update mcp doc (#4572)

docSite/content/zh-cn/docs/development/upgrading/465.md

@@ -21,10 +21,10 @@ weight: 831
 
 
 ## V4.6.5 功能介绍
 ## 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. 新增 - 【内容提取】模块支持选择模型，以及字段枚举
 5. 新增 - 【内容提取】模块支持选择模型，以及字段枚举
 6. 优化 - docx读取，兼容表格（表格转markdown）
 6. 优化 - docx读取，兼容表格（表格转markdown）
 7. 优化 - 高级编排连接线交互
 7. 优化 - 高级编排连接线交互

docSite/content/zh-cn/docs/development/upgrading/468.md

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

docSite/content/zh-cn/docs/guide/workbench/basic-mode.md → docSite/content/zh-cn/docs/guide/dashboard/basic-mode.md

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

docSite/content/zh-cn/docs/guide/workbench/gapier.md → docSite/content/zh-cn/docs/guide/dashboard/gapier.md

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

docSite/content/zh-cn/docs/guide/workbench/intro.md → docSite/content/zh-cn/docs/guide/dashboard/intro.md

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

docSite/content/zh-cn/docs/guide/dashboard/mcp_server.md

+---
+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
+```
\ No newline at end of file

projects/mcp_server/src/index.ts

@@ -38,18 +38,18 @@ app.get('/:key/sse', async (req, res) => {
   );
   );
 
 
   transport.onclose = () => {
   transport.onclose = () => {
-    addLog.info(`Transport ${transport.sessionId} closed`);
+    addLog.info(`Transport closed ${transport.sessionId}`);
     delete transportMap[transport.sessionId];
     delete transportMap[transport.sessionId];
   };
   };
   transport.onerror = (err) => {
   transport.onerror = (err) => {
-    addLog.error(`Transport ${transport.sessionId} error`, err);
+    addLog.error(`Transport error ${transport.sessionId}`, err);
   };
   };
   server.onclose = () => {
   server.onclose = () => {
-    addLog.info(`Server ${transport.sessionId} closed`);
+    addLog.info(`Server closed ${transport.sessionId}`);
     delete transportMap[transport.sessionId];
     delete transportMap[transport.sessionId];
   };
   };
   server.onerror = (err) => {
   server.onerror = (err) => {
-    addLog.error(`Server ${transport.sessionId} error`, err);
+    addLog.error(`Server error ${transport.sessionId}`, err);
   };
   };
 
 
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
   server.setRequestHandler(ListToolsRequestSchema, async () => ({