nova-act-mcp-server

nova-act-mcp-server 是一个零安装的 Model Context Protocol (MCP) 服务器，它暴露了 Amazon Nova Act 浏览器自动化工具供AI代理使用。

v3.2.0 新增内容

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

快速开始 (uvx)

第一步：获取 Nova Act API 密钥

从 Nova Act 获取您的API密钥。

第二步：添加到 MCP 客户端配置

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

第三步：开始使用浏览器工具

AI代理现在可以通过任何兼容MCP的客户端（如Claude Desktop或VS Code）调用工具，例如 start_session、execute_instruction 等。

核心工具概述

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

本地开发与测试

设置

# 克隆仓库
git clone https://github.com/madtank/nova-act-mcp.git
cd nova-act-mcp

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

# 使用开发依赖项安装
uv pip install -e .[dev]

运行测试

# 运行所有测试（集成测试需要NOVA_ACT_API_KEY）
pytest

# 仅运行单元测试（不需要API密钥）
pytest tests/unit

# 运行集成测试（需要API密钥）
NOVA_ACT_API_KEY="your_key_here" pytest tests/integration

使用 MCP Inspector UI 本地运行

# 使用MCP Inspector启动服务器
npx @modelcontextprotocol/inspector -e PYTHONUNBUFFERED=1 -e NOVA_ACT_API_KEY="YOUR_KEY" -- python -m nova_mcp_server

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

高级工具

工具	描述
fetch_file	从当前页面下载文件
view_html_log	获取当前页面的HTML内容
compress_logs	创建并返回包含会话日志和截图的ZIP文件

许可证

MIT