AI导哈

浏览器自动化工具服务

nova-act-mcp-server 是一个无需安装的 Model Context Protocol (MCP) 服务器，为 AI 代理提供 Amazon Nova Act 浏览器自动化工具。

  • by madtank
  • Python
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 madtank/nova-act-mcp

使用说明

nova-act mcp服务器

nova-act-mcp服务器 是零安装 模型上下文协议 暴露的（MCP）服务器 《亚马逊新星法案》 AI代理的浏览器自动化工具。

v3.2.0的新增功能

  • 基于文件的屏幕截图：截图现在保存到文件中，而不是内联base64，消除了MCP消息大小限制
  • 优化图像质量：较小文件大小（~50KB vs 500KB+）的屏幕截图质量降低（60/30）
  • 增强的错误处理：改进了浏览器操作的异常处理
  • 更好的测试：屏幕截图功能的全面测试覆盖率
  • MCP检查器集成：新的测试脚本，便于验证

快速入门（uvx）

步骤1：获取Nova Act API密钥

从获取API密钥 诺瓦法案.

步骤2：添加到MCP客户端配置

{
  "mcpServers": {
    "nova_act_browser_tools": {
      "command": "uvx",
      "args": ["nova-act-mcp-server"],
      "env": { "NOVA_ACT_API_KEY": "YOUR_NOVA_ACT_API_KEY_HERE" }
    }
  }
}

步骤3：开始使用浏览器工具

AI代理现在可以调用以下工具 start_session, execute_instruction通过任何兼容MCP的客户端（如Claude Desktop或VS Code）进行操作。

核心工具概述

工具 说明 关键参数
start_session 启动新的浏览器会话 url, headless=True
execute_instruction 在浏览器中运行自然语言指令 session_id, instruction
inspect_browser 获取当前浏览器的屏幕截图和状态 session_id, include_screenshot=True
end_session 关闭浏览器会话并清理资源 session_id
list_browser_sessions 列出所有活动的浏览器会话 无

本地开发和测试

设置

# Clone the repository
git clone https://github.com/madtank/nova-act-mcp.git
cd nova-act-mcp

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install with development dependencies
uv pip install -e .[dev]

运行测试

# Run all tests (integration tests require NOVA_ACT_API_KEY)
pytest

# Run only unit tests (no API key required)
pytest tests/unit

# Run integration tests (requires API key)
NOVA_ACT_API_KEY="your_key_here" pytest tests/integration

使用MCP检查器UI在本地运行

# Start the server with the MCP Inspector
npx @modelcontextprotocol/inspector -e PYTHONUNBUFFERED=1 -e NOVA_ACT_API_KEY="YOUR_KEY" -- python -m nova_mcp_server

然后访问 http://localhost:6274 在您的浏览器中。为了获得最佳体验，请将检查器UI超时设置为60秒 start_session 操作。

高级工具

工具 说明
fetch_file 从当前页面下载文件
view_html_log 获取当前页面的HTML内容
compress_logs 创建并返回一个ZIP格式的会话日志和屏幕截图

许可证

麻省理工学院

相关 MCP