Agentbay

Wuying AgentBay MCP Server

English | 中文

概述

阿里云无影 AgentBay 是为 AI 时代的 Agent 打造的云基础设施，为企业、开发者和 AI 服务商提供一键配置工具和 AI Agent 任务执行环境。借助无影 API 或 AgentBay MCP Server，Agent 应用可以快速集成并使用相关工具，在云环境中以无服务器方式运行。

什么是无影？

无影（Wuying），又称阿里云云电脑，是阿里云创新的云网融合计算架构，通过云电脑、云应用和云终端提供安全、高效的计算体验。其特点包括：

• 高安全性
• 零维护
• 轻资产管理
• 易于集成
• 全球部署，低延迟访问

什么是 AgentBay？

AgentBay 是无影专为 AI Agent 打造的云基础设施，可提供：

• 可一键配置的 AI Agent 任务执行工具
• 安全的执行环境
• 面向开发者和 AI 服务商的企业级基础设施
• 通过 SDK 和 MCP Server 快速集成
• 无服务器能力

主要功能

1. 标准运行环境

   • 预集成用于 Agent 任务执行的标准工具
   • MCP（模型上下文协议）封装
   • 快速企业集成能力

2. 用户状态持久化

   • 安全隔离用户配置和 Cookie
   • 动态挂载用户状态
   • 云环境与本地环境高度相似

3. 实时边缘云交互

   • 专有 ASP 协议，用于实时边缘云流传输
   • 本地设备感知与控制
   • 网络和外设重定向通道

技术架构

• 持久化系统：自定义持久化存储，用于保留用户状态和文件
• 边缘云通信：专有 ASP 协议，用于云端与终端设备之间的实时通信
• 基础设施：基于阿里云资源池，支持在数秒内扩展至 10,000 个并发操作
• 服务模式：无服务器能力，支持一键管理环境会话
• 工具集成：Browser、File、Terminal 等标准 MCP 工具
• 集成选项：兼容 SDK+API 或 MCP Server

云服务规格

云资源

该服务支持调用共享资源，公测期间提供有限的免费服务，并发上限为 10 个实例。服务区域会根据客户访问 IP 自动分配。

运行环境

该服务支持内置 Linux 版本镜像。无影会持续丰富并更新镜像能力，同时确保向后兼容。

MCP 工具

首发环境默认支持 Browser 工具、File 工具和 Terminal 工具。有关工具的更多更新，请访问官方网站。

快速开始

步骤 1：创建 API Key

请创建自己的 API Key。

1. 登录 AgentBay 控制台。
2. 点击左侧导航栏中的 服务管理。
3. 在 服务管理 页面中，点击 创建 API KEY。
4. 在 创建 API KEY 对话框中输入名称，然后点击 确定。

注意：公测期间最多只能创建 10 个 API Key。创建的 API Key 会显示在服务管理页面的列表中，你可以复制以供后续使用。

步骤 2：完成 MCP 服务配置

确认运行时环境并获取 MCP 信息。

1. 登录 AgentBay 控制台。
2. 点击左侧导航栏中的 配置资源。
3. 从 API Key 下拉列表中选择已创建的 API Key。
4. 从 选择镜像 下拉列表中选择一个镜像。

注意：该服务支持内置的 Linux 版本镜像。无影会在确保向后兼容的同时，持续丰富和更新镜像能力。

5. 在 工具能力和接口 右侧，查看可用的 MCP 工具。点击 查看 可了解更多详情。
6. 在 获取 MCP 信息 文本框中，点击右上角的 复制代码，并将代码添加到支持 MCP 的工具中（例如 Cline、Cursor 等）。

以下是使用 Cursor V0.48.9 的示例：

• 打开 Cursor 设置 面板，点击左侧导航栏中的 MCP。
• 在 MCP 服务器 面板中，点击右上角的 添加新的全局 MCP 服务器。
• 将以下代码粘贴到打开的 mcp.json 文件中并保存。支持 SSE 和 STDIO 两种安装方式。

注意：请将 YOUR_API_KEY 替换为步骤 1 中创建的、以 akm- 开头的 API Key。

以下是使用 SSE 方式的示例： SSE 方式会在每次运行服务时通过在线长连接完成握手，无需下载插件。

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyun.com/sse?APIKEY=YOUR_API_KEY"
    }
  }
}

任务执行完成后，云环境可能会释放。如果希望下次保留相关配置或环境，请在上述代码中添加 EXTERNALID 参数。示例如下：

{
  "mcpServers": {
    "wuying_mcp_server": {
      "url": "https://agentbay.wuying.aliyun.com/sse?APIKEY=YOUR_API_KEY&EXTERNALID=user001"
    }
  }
}

步骤 3：使用屏幕流（可选）

支持通过嵌入 iframe 的无影 Web SDK 打开云电脑屏幕，也支持通过浏览器拉取无影 Web 客户端。调用云电脑屏幕流时，MCP 会返回一个包含登录参数的链接，格式为 https://wuying.aliyun.com?mcp.html?authcode=<authCode>&resourceId=<resourceId>。

• 此链接有有效期和打开次数限制，建议立即使用。
• 可通过 URL 中的参数 &input=true&keyboard=true 配置键盘和鼠标交互开关，也可通过 Web SDK 界面实时配置交互开关。详细信息请参阅 Web SDK 文档。

后续步骤

你可以使用内置提示词测试效果，例如 使用 wuying-agentbay 打开浏览器并访问 wuying.aliyun.com 或类似提示词。配置正确后，无影云环境将会启动并执行浏览器操作。在此过程中，模型会提供一个 Web 链接，供你打开无影屏幕流并接管操作。

许可证

MIT

支持

如需支持和了解更多信息，请访问：

• 阿里云无影文档
• AgentBay 产品页面