📖 Installation Guide — quick start, manual setup, and troubleshooting

FastMCP 3.2 server that wraps OpenManus (FOSS agent framework) into MCP tools, with a SOTA fleet webapp dashboard.

Includes Windows-native computer use (mouse/keyboard/screenshot via win32 API) and bash execution — both with security hardening.

MCP hosts ←→ openmanus-mcp (FastMCP 3.2, stdio)
                   ↕ subprocess / REST
              OpenManus agent
                   ├── bash (denylisted)
                   ├── computer (local win32)
                   ├── python_execute (restricted)
                   ├── browser_use (Playwright)
                   └── str_replace_editor (workspace-scoped)

• FastAPI backend on :10768 — /api/v1/* for webapp + fleet
• Vite + React dashboard on :10769 — SOTA fleet standards
• OpenManus fork at sandraschi/OpenManus — security-hardened

git clone https://github.com/sandraschi/openmanus-mcp
cd openmanus-mcp
just

This opens an interactive dashboard showing all available commands. Run just bootstrap to install dependencies, then just serve or just dev to start.

If you don't have just installed:

.\web_sota\start.ps1

uv run python -m openmanus_mcp # MCP server uv run python -m openmanus_mcp.run_api # FastAPI backend cd web_sota && npm run dev # Frontend

Set OPENMANUS_MCP_API_KEY for API authentication: $env:OPENMANUS_MCP_API_KEY = "your-secret-key" If not set, a random key is auto-generated and written to .api_key.

See SECURITY.md and Upstream SECURITY.md.

• Python 3.12+
• uv
• OpenManus fork (sandraschi/OpenManus)
• Windows (for computer use tool; bash works cross-platform)