Agent机顶盒MCP
腾讯云AI代理沙盒服务-MCP协议实现
特性 • 结构 • 快速开始 • 指南 • 贡献 • 许可证
______________________________________________________________________
介绍
Agent Sandbox（AGS）是腾讯云为人工智能代理开发的下一代沙盒执行环境，其特点是 安全隔离, 极端性能，以及 可扩展性它支持多种沙盒类型，包括浏览器、代码和自定义沙盒，使代理能够在受控环境中运行，并与数字世界安全交互。
该项目提供了一个基于 模型上下文协议（MCP），包括浏览器沙箱和代码沙箱功能，支持与任何兼容MCP的AI客户端无缝集成。
主要特点
🔒 安全隔离
- 完全隔离的沙盒执行环境
- 防止恶意代码影响主机系统
- 资源使用限制和监控
⚡ 卓越的性能
- 毫秒级沙盒启动
- 高并发支持，单机可以承载多个沙盒实例
- 智能资源调度与优化
🔧 可扩展架构
- 支持多种沙盒类型（浏览器、代码、自定义）
- 基于标准MCP协议，易于集成
- 灵活的配置和扩展机制
🌐 浏览器MCP-浏览器沙盒
基于Playwright的浏览器自动化MCP服务器（TypeScript实现）
- ✅ 快速轻量级的无头浏览器控制
- ✅ 基于结构化的可访问性快照，不需要视觉模型
- ✅ 支持页面导航、元素交互、表单填写
- ✅ 截图、PDF生成、JavaScript执行
- ✅ 网络监控、控制台捕获、标签管理
- ✅ 可选浏览器扩展支持
🐍 代码MCP-代码沙盒
Python代码执行MCP服务器（Python实现）
- ✅ 安全的代码沙盒执行环境
- ✅ 支持实时Python代码执行
- ✅ 文件系统访问和管理
- ✅ 完全隔离的运行时环境
- ✅ 支持自定义依赖项安装
项目结构
agentsandbox-mcp/
├── browser-mcp/ # TypeScript - Browser MCP Server
│ ├── src/ # Source code
│ ├── tests/ # Test files
│ ├── extension/ # Browser extension
│ ├── examples/ # Usage examples
│ ├── package.json # NPM configuration
│ ├── cli.js # CLI entry point
│ └── README.md # Documentation
├── code-mcp/ # Python - Code MCP Server
│ ├── src/ # Source code
│ │ └── server.py # MCP server implementation
│ ├── main.py # Entry point
│ ├── pyproject.toml # Python project configuration
│ └── README.md # Documentation
├── CODE_OF_CONDUCT.md # Code of Conduct
├── CONTRIBUTING.md # Contributing Guide
├── LICENSE # Apache 2.0 License
└── README.md # Project README (this file)快速开始
需求
- 浏览器MCP：Node.js 18+
- 代码MCP：Python 3.8+和uv
安装与使用
浏览器MCP服务器
cd browser-mcp
# Install dependencies
npm install
# Run in development mode
npm run watch
# Or use npx directly
npx @tencent/agentsandbox-browser-mcp在MCP客户端中配置：
{
"mcpServers": {
"agentsandbox-browser": {
"command": "npx",
"args": ["@tencent/agentsandbox-browser-mcp"]
}
}
}支持的MCP客户端：Claude Desktop、VS Code、Cursor、Windsurf、Goose、LM Studio等。
有关详细文档，请参阅 浏览器mcp/README.md
MCP服务器代码
cd code-mcp
# Install dependencies with uv
uv sync
# Configure environment variable (required)
export E2B_API_KEY="your-e2b-api-key"
# Run server
python main.py获取API密钥： 访问 腾讯云代理沙盒 注册并获取您的API密钥。
有关详细文档，请参阅 代码mcp/README.md
使用指南
用例
🔍 智能Web分析
使用浏览器沙箱，AI代理可以：
- 自动信息抓取和数据收集
- 自动填写和提交表格
- Web内容理解与信息提取
- 自动化测试和监控
📊 数据分析处理
使用代码沙箱，AI代理可以：
- 执行复杂的数据分析任务
- 生成可视化图表和报告
- 文件处理和格式转换
- 科学计算和算法验证
🤖 代理协作
结合这两个沙盒可以实现：
- Web数据抓取+数据分析处理
- 动态内容生成+浏览器预览
- 端到端自动化工作流程
浏览器MCP工具
浏览器MCP提供以下MCP工具：
- 导航:
playwright_navigate,playwright_screenshot - 元素交互:
playwright_click,playwright_fill,playwright_select,playwright_hover - JavaScript执行:
playwright_evaluate - 页面管理:
playwright_snapshot,playwright_new_page,playwright_close_page - 文件操作:
playwright_upload_files,playwright_download_files - 对话框处理:
playwright_accept_dialog,playwright_dismiss_dialog
代码MCP功能
MCP代码提供以下功能：
- 代码执行：在完全隔离的沙盒中安全执行Python代码
- 文件系统：支持文件读/写、目录管理和其他文件系统操作
- 环境持久性：沙盒环境可以持久化，支持多种交互
- 依赖管理：支持动态安装和使用第三方Python包
技术架构
核心技术栈
| 模块 | 语言 | 主要依赖项 | 沙盒类型 |
|---|---|---|---|
| 浏览器MCP | TypeScript | Playwright 1.56，@modelcontextprotocol/sdk，commander，zod | 浏览器沙盒 |
| 代码MCP | Python | @e2b/代码解释器2.0，@modelcontextprotocol/sdk | 代码沙盒 |
AGS核心功能
- 标准MCP协议：与模型上下文协议规范完全兼容，确保与主流AI客户端无缝集成
- 独立部署：两台MCP服务器可以独立使用或组合使用，灵活满足不同场景需求
- 安全隔离：浏览器和代码执行都在严格隔离的沙盒环境中运行，确保系统安全
- 高性能：使用轻量级容器技术，实现毫秒级启动和高并发支持
- 易于扩展：开放式架构设计，支持自定义沙盒类型和工具扩展
沙盒类型
腾讯云AGS支持多种沙盒类型：
- 浏览器沙盒：使AI代理能够像人类一样浏览网页、填写表单和提取信息
- 代码沙盒：为AI代理提供安全的代码执行环境，支持数据分析、文件处理和其他任务
- 自定义沙盒：支持根据业务需求定制特定的沙盒环境（计划中）
文档
贡献
我们欢迎各种各样的贡献！无论是错误报告、功能建议、文档改进还是代码贡献。
如何做出贡献
- 分叉此项目
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'feat: add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
有关详细指南，请参阅 贡献.md
行为准则
请注意，该项目遵循 贡献者公约行为准则。参与此项目即表示您同意遵守其条款。
许可证
该项目在Apache许可证2.0下开源。看 许可证 文件以获取详细信息。
Copyright 2024-2025 AgentSandbox MCP Contributors
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.相关链接
- 腾讯云AGS官方文档 -深入了解AGS服务详情
- 模型上下文协议 -MCP官方协议规范
- 剧作家 -浏览器自动化框架
联系
- 提交问题：
- 腾讯云官方支持： 联系我们
关于腾讯云AGS
Agent Sandbox（AGS）是腾讯云的企业级AI代理沙盒服务，为开发者提供：
- ☁️ 云部署：无需构建现成的基础设施
- 🔐 企业安全：满足企业安全和合规要求
- 📈 弹性伸缩：根据业务需求自动扩展
- 💼 专业支持：提供全天候技术支持服务
这个开源项目提供了一个基于MCP协议的本地化实现，帮助开发人员快速体验和集成AGS功能。
______________________________________________________________________
⭐️ 如果这个项目对你有帮助，请给我们一颗星！