About iflow-mcp_madtank-nova-act-mcp-server
iflow-mcp_madtank-nova-act-mcp-server is an MCP server in the Browser category: an MCP server providing tools to control web browsers using the Amazon Nova Act SDK.
Install
uvx iflow-mcp-madtank-nova-act-mcp-serverpip install iflow-mcp-madtank-nova-act-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (5)
end_sessionCloses a browser session and cleans up resources
Parameters not published.
execute_instructionRuns a natural language instruction in the browser
Parameters not published.
inspect_browserGets a screenshot and state of the current browser
Parameters not published.
list_browser_sessionsLists all active browser sessions
Parameters not published.
start_sessionStarts a new browser session
Parameters not published.
Ask AI
Ask AI about iflow-mcp_madtank-nova-act-mcp-server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
nova-act-mcp-server
nova‑act‑mcp‑server is a zero‑install Model Context Protocol (MCP) server that exposes Amazon Nova Act browser‑automation tools for AI agents.
What's New in v3.2.0
- File-Based Screenshots: Screenshots now save to files instead of inline base64, eliminating MCP message size limits
- Optimized Image Quality: Reduced screenshot quality (60/30) for smaller file sizes (~50KB vs 500KB+)
- Enhanced Error Handling: Improved exception handling for browser operations
- Better Testing: Comprehensive test coverage for screenshot functionality
- MCP Inspector Integration: New testing script for easy validation
Quick Start (uvx)
Step 1: Get a Nova Act API Key
Obtain your API key from Nova Act.
Step 2: Add to MCP Client Configuration
{
"mcpServers": {
"nova_act_browser_tools": {
"command": "uvx",
"args": ["nova-act-mcp-server"],
"env": { "NOVA_ACT_API_KEY": "YOUR_NOVA_ACT_API_KEY_HERE" }
}
}
}
Step 3: Start Using Browser Tools
AI agents can now call tools like start_session, execute_instruction, etc. through any MCP-compatible client such as Claude Desktop or VS Code.
Core Tools Overview
| Tool | Description | Key Parameters |
|---|---|---|
start_session |
Starts a new browser session | url, headless=True |
execute_instruction |
Runs a natural language instruction in the browser | session_id, instruction |
inspect_browser |
Gets a screenshot and state of the current browser | session_id, include_screenshot=True |
end_session |
Closes a browser session and cleans up resources | session_id |
list_browser_sessions |
Lists all active browser sessions | None |
Local Development & Testing
Setup
# 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]
Running Tests
# 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
Running Locally with MCP Inspector 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
Then visit http://localhost:6274 in your browser. For optimal experience, set the Inspector UI timeout to 60 seconds for start_session operations.
Advanced Tools
| Tool | Description |
|---|---|
fetch_file |
Downloads a file from the current page |
view_html_log |
Gets the HTML content of the current page |
compress_logs |
Creates and returns a ZIP of session logs and screenshots |
License
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.