diff --git a/docs/zh/openEuler_intelligence/mcp_agent/mcp_guide.md b/docs/zh/openEuler_intelligence/mcp_agent/mcp_guide.md index c30fbf395d7b81d0df69b9d7cb5565e3cbee7e18..fe12cab4e6a39efb6e0fe27bede4487559317655 100644 --- a/docs/zh/openEuler_intelligence/mcp_agent/mcp_guide.md +++ b/docs/zh/openEuler_intelligence/mcp_agent/mcp_guide.md @@ -1,3 +1,90 @@ # MCP 服务指南 -（当前内容待更新，请等待） \ No newline at end of file +## 1. 概述 + +openEuler intelligence 当前版本对 MCP 的支持已得到增强，使用流程主要分为以下步骤： + +1. 注册 MCP +2. 安装 MCP +3. 激活 MCP 并载入配置文件 +4. 基于已激活的 MCP 构建 Agent +5. 测试 Agent +6. 发布 Agent +7. 使用 Agent + +> **说明**： +> +> - 注册、安装和激活 MCP 需管理员权限操作 +> - 构建、测试、发布和使用 Agent 为普通用户权限操作 +> - 所有 Agent 相关操作均需基于已激活的 MCP 进行 + +## 2. MCP 的注册、安装与激活 + +以下流程以管理员账号为例，展示 MCP 的完整管理流程： + +1. **注册 MCP** + 通过插件中心的 "MCP 注册" 按钮，将 MCP 注册到 openEuler intelligence 系统中 + ![mcp注册按钮](pictures/regeister_mcp_button.png) + + 点击按钮后弹出注册窗口（SSE 和 STDIO 的默认配置如下）： + ![sse注册窗口](pictures/sse_mcp_register.png) + ![stdio注册窗口](pictures/stdio_mcp_register.png) + + 以 SSE 注册为例，填写配置信息后点击"保存" + ![填入mcp配置文件](pictures/add_mcp.png) + +2. **安装 MCP** + + > **注意**：安装 STDIO 前，可在对应容器或服务器的 `/opt/copilot/semantics/mcp/template` 目录下调整服务依赖文件及权限 + + 点击已注册的 MCP 卡片上的"安装"按钮进行安装 + ![mcp安装按钮](pictures/sse_mcp_intstalling.png) + +3. **查看 MCP 工具** + 安装成功后，点击 MCP 卡片可查看该服务支持的工具 + ![mcp服务工具](pictures/mcp_details.png) + +4. **激活 MCP** + 点击"激活"按钮启用 MCP 服务 + ![mcp激活按钮](pictures/activate_mcp.png) + +## 3. Agent 应用的创建、测试、发布与使用 + +以下操作可由普通用户完成，所有操作均需基于已激活的 MCP 进行： + +1. **创建 Agent 应用** + 点击应用中心的"创建应用"按钮 + ![创建agent应用](pictures/create_app_button.png) + +2. **配置 Agent 应用** + 创建成功后，点击应用卡片进入详情页，可修改应用配置信息 + ![修改agent应用配置](pictures/edit_Agent_app_message.png) + +3. **关联 MCP** + 点击"添加 MCP"按钮，在左侧弹出的列表中选择已激活的 MCP 进行关联 + ![添加mcp](pictures/add_mcp_button.png) + ![mcp列表](pictures/add_mcp.png) + +4. **测试 Agent 应用** + 完成 MCP 关联和信息配置后，点击右下角"测试"按钮进行功能测试 + ![测试agent应用](pictures/test_mcp.png) + +5. **发布 Agent 应用** + 测试通过后，点击右下角"发布"按钮发布应用 + ![发布agent应用](pictures/publish_app.png) + +6. **使用 Agent 应用** + 发布后的应用将显示在应用市场中，双击即可使用 + ![使用agent应用](pictures/click_and_use.png) + + Agent 应用有两种使用模式： + + - **自动模式**：无需用户手动确认，自动执行操作 + ![自动使用agent应用](pictures/chat_with_auto_excute.png) + + - **手动模式**：执行前会提示风险，需用户确认后才执行 + ![手动使用agent应用](pictures/chat_with_not_auto_excute.png) + +## 4. 总结 + +通过上述流程，用户可基于 MCP 构建并使用自定义的 Agent 应用。欢迎体验并探索更多功能场景。 diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/activate_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/activate_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..61533013f8629ce483c3ccb074ab0c1041c430cb Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/activate_mcp.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..32f0f84879dcef4193cb912878bea5d87a86dd1c Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp_button.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp_button.png new file mode 100644 index 0000000000000000000000000000000000000000..ad6ceb728d861cf16bcc3fbe1071c1ff376e0956 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/add_mcp_button.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_auto_excute.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_auto_excute.png new file mode 100644 index 0000000000000000000000000000000000000000..f7eb8e06eeb54e3f5c038b60bfd603953cae30f3 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_auto_excute.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_not_auto_excute.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_not_auto_excute.png new file mode 100644 index 0000000000000000000000000000000000000000..1bfa31b6396680e0359f2176750462ca33862594 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/chat_with_not_auto_excute.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_Agent_app_to_create.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_Agent_app_to_create.png new file mode 100644 index 0000000000000000000000000000000000000000..b1c200e6b0092c043b3cb99f3c7def4fe101ad94 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_Agent_app_to_create.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..4d50d4e3f6330062846d85d7bf7b66e34b1a3b98 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp_2.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp_2.png new file mode 100644 index 0000000000000000000000000000000000000000..693d6e607c2872123e1a506237f53cacebad3af8 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/choose_mcp_2.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/click_and_use.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/click_and_use.png new file mode 100644 index 0000000000000000000000000000000000000000..281e8c736baf98c29cf3991e43dfe18cb4fc89be Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/click_and_use.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/create_app_button.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/create_app_button.png new file mode 100644 index 0000000000000000000000000000000000000000..fce7d20de9e28a6e066f0cd9be16fc2dcdd350c7 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/create_app_button.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/edit_Agent_app_message.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/edit_Agent_app_message.png new file mode 100644 index 0000000000000000000000000000000000000000..eea98c7db7b4c93ea54bd83b18687159ed7e4c6b Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/edit_Agent_app_message.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/installed_sse_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/installed_sse_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..f9d98d5f7aa424e0ceef901688424538cd26b18d Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/installed_sse_mcp.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/mcp_details.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/mcp_details.png new file mode 100644 index 0000000000000000000000000000000000000000..f374a96687a4d98d65ee199be059212a61cf2692 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/mcp_details.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/publish_app.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/publish_app.png new file mode 100644 index 0000000000000000000000000000000000000000..3785369ddd009e4c0e2d08d2134dfffde5a101b6 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/publish_app.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/regeister_mcp_button.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/regeister_mcp_button.png new file mode 100644 index 0000000000000000000000000000000000000000..f3145eb9c93123b7b7417239f71d564f8ce4558c Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/regeister_mcp_button.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_config.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_config.png new file mode 100644 index 0000000000000000000000000000000000000000..2f9fba9632ebf4da993ac62283c4cf3120a45faf Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_config.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_intstalling.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_intstalling.png new file mode 100644 index 0000000000000000000000000000000000000000..52f6ab4d5a51f3af5710c8c024e127fdff2a7e00 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_intstalling.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_register.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_register.png new file mode 100644 index 0000000000000000000000000000000000000000..8ed20b064a11c3442ec7fafcf76bbd2f6fab0a64 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/sse_mcp_register.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/stdio_mcp_register.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/stdio_mcp_register.png new file mode 100644 index 0000000000000000000000000000000000000000..620a664fd63666ab224ea3d64d90417f482cba7a Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/stdio_mcp_register.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/test_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/test_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..18143d4ea7e65f1b61b2618c06ac579ec516a018 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/test_mcp.png differ diff --git a/docs/zh/openEuler_intelligence/mcp_agent/pictures/uninstalled_stdio_mcp.png b/docs/zh/openEuler_intelligence/mcp_agent/pictures/uninstalled_stdio_mcp.png new file mode 100644 index 0000000000000000000000000000000000000000..101ab687f2e28593fcce5dcfc27c1d2b8866d640 Binary files /dev/null and b/docs/zh/openEuler_intelligence/mcp_agent/pictures/uninstalled_stdio_mcp.png differ