convez.ai
MCP Server
sandraschi

openmanus-mcp

sandraschi/openmanus-mcp

Ver no GitHub
BomPluginScore · de 0 a 100

FastMCP 3.1 Server + Webapp wrapping OpenManus (FOSS CLI, 100% local LLM when you configure Ollama / LM Studio in OpenManus). Not Manus.im.

Instalação

$npx convez-ai sandraschi/openmanus-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
1
Acompanhando
0
Saúde
85%
Último commit
há 2 semanas
Versão
v0.1.0a1
Issues abertas
1
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

openmanus-mcp — MCP bridge + dashboard for OpenManus

📖 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.

Architecture

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

Features

CapabilityDetail
Computer useWindows-native mouse/keyboard/screenshot (win32 API, no Docker/cloud needed)
Bash executionFull terminal with denylist (rm -rf /, sudo, useradd, dd blocked)
Python executionRestricted builtins — os/subprocess/socket imports blocked
Web browsingPlaywright-based browser automation
File editingRead/write/edit files scoped to workspace root
API securityOptional Bearer token auth on all REST endpoints
Fleet integrationRegistered in mcp-central-docs, fleet discovery, glama.json

Ports

PortService
10768Backend (FastAPI)
10769Frontend (Vite)

Quick Start

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.

Manual Setup

If you don't have just installed:

Start everything

.\web_sota\start.ps1

Or individually:

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

Configuration

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.

Security

See SECURITY.md and Upstream SECURITY.md.

ToolRiskMitigation
bashCriticalDenylist + obfuscation detection
computerHighConfirmation gate (blocked in headless)
python_executeHighRestricted builtins
str_replace_editorModerateWorkspace-scoped paths
APIHighOptional Bearer auth

Requirements

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

Bom para

Relacionados