[!NOTE]
This README describes the current source tree. Packaged releases may not yet include every feature documented here; check the release notes for your version.
AI Agents need tools, but managing dozens of MCP servers across different clients is a mess. I wanted a single gateway that aggregates everything, filters by context, and keeps running in the background — all controllable from a beautiful native UI.
Moor is a local MCP control plane for Mac. It gives every coding agent one safe, observable, configurable gateway to your MCP servers.
Estrelas
163
Ferramentas
—
Disponibilidade
—
Moor exposes one endpoint (http://127.0.0.1:<port>/mcp) that dynamically serves only the tools you want, based on your active Profile. Switch profiles without disconnecting your Agent, with tool-call auditing enabled by default. That's why I built it.
Install
macOS App
Download the .dmg from Releases, drag to Applications, done. The app embeds a Rust HTTP gateway in the desktop process — no pre-installed Node.js runtime required.
Windows App
Download the Windows installer from Releases and run it. The app embeds a Rust HTTP gateway in the desktop process — no pre-installed Node.js runtime required.
Linux App
Download the .deb, .rpm, or .AppImage from Releases (x86_64 and aarch64 builds are produced by CI). The app embeds a Rust HTTP gateway in the desktop process — no pre-installed Node.js runtime required. macOS remains the primary target; Linux builds are produced by CI but less extensively tested.
Build from Source
Requires macOS (Apple Silicon / Intel), Windows x64, or Linux (x86_64 / aarch64), Node.js >= 22 (CI uses 24), pnpm 11.3.0 (as pinned in package.json), and the stable Rust toolchain used by CI.
git clone https://github.com/varandrew/moor.git
cd moor
pnpm install
Open Moor from your applications menu (Moor.app on macOS). The Dashboard shows your active Profile, server status, and recent audit logs at a glance.
Scan Existing Configs
Moor can automatically detect MCP servers you've already configured for Claude Code, Claude Desktop, Codex, OpenCode, Cursor, Kimi Code, dsh, Grok Build, and Pi:
Go to Servers → Import
Click Scan — Moor reads ~/.claude.json, ~/.codex/config.toml, ~/.config/opencode/opencode.json / .jsonc, ~/.cursor/mcp.json, ~/.kimi-code/mcp.json, ~/.dsh/cordis.patch.yml, ~/Library/Application Support/Claude/claude_desktop_config.json, ~/.grok/config.toml, and ~/.pi/agent/mcp.json (Pi needs the community adapter: pi install npm:pi-mcp-adapter)
Select the servers you want to import
You can also paste a JSON MCP configuration with Import JSON. Moor imports stdio and HTTP/SSE servers, and reports unsupported entries such as OpenAPI configs without saving them.
Start the imported servers from Servers so Moor can discover their tools. Enabling a server in a Profile controls exposure; it does not start the server.
Create a Profile
Profiles let you group servers and control which tools are exposed to Agents:
Go to Profiles → New Profile
Name it (e.g., "Coding", "Research")
Toggle servers on/off
Expand a server to enable/disable individual tools
Optionally choose Curated listing and select tools to pin; Direct listing is the default
Click Activate — the change is instant
Connect Your Agent
Point any MCP-compatible client to Moor's single endpoint:
http://127.0.0.1:9223/mcp
9223 is the default gateway port. If it is already in use, Moor picks the next available port and shows the actual endpoint in the Dashboard and Client Config pages.
By default the /mcp endpoint is loopback-only and does not require X-Moor-Token (see LAN access below). Moor uses X-Moor-Token only for local management APIs between the WebView and gateway, so you do not need to paste it into agent configs.
To connect from WSL2 (NAT mode) or another LAN device, enable Settings → Advanced → Allow LAN MCP Access and restart Moor. The gateway then binds to all interfaces and /mcp additionally accepts private-network hosts (10.x.x.x, 172.16.x.x–172.31.x.x, 192.168.x.x); /api/* stays loopback-only and token-protected. Windows may prompt to allow Moor through the firewall.
Moor handles the rest — aggregating tools/list, routing tools/call, and filtering based on your active Profile.
Adjust MCP Timeouts
If a stdio server starts through npx, pnpm dlx, or a package manager that downloads dependencies, its first initialize / tools/list may exceed the default 30 seconds. In Settings → Advanced, increase Server Start Timeout for startup or Request Timeout for running tools/call requests. Both settings accept 5–300 seconds.
Preinstall frequently used servers and use absolute command paths to reduce startup delays. To start them when Moor launches, enable Auto-start on each server and Auto-start Servers on Launch in Settings; only servers enabled in the active Profile are started.
Features
MCP Gateway Aggregation
A single HTTP endpoint (/mcp) proxies all backend MCP servers. Agents see a unified tool catalog — no need to configure multiple endpoints.
Multi-Transport Support
Connect to both stdio (subprocess) and HTTP/SSE MCP servers. Moor manages connections and server lifecycles, with optional periodic health checks.
Profile Management
Create unlimited Profiles for different workflows. Each Profile stores:
Which servers are enabled
Which tools are disabled per server
Which tools are pinned, the exposure mode, and the risk policy
A global active state
Switch Profiles with hot-swap — connected Agents stay connected, and the next tools/list reflects the new configuration immediately.
Tool-Level Toggles
Beyond server-level on/off, drill into any server to disable specific tools. Disabled tools are excluded from the Agent's tool catalog and cannot be called.
Curated Exposure and Pinned Tools
Direct listing is the default for new and existing Profiles and lists every enabled, callable tool allowed by the Profile's policy. Curated listing lists only pinned tools plus two gateway meta tools:
moor_search_tools: search available tools by keyword and server name, with pagination and input schemas in the results
moor_call_tool: call a discovered tool by its exposed name and return the downstream result
Use the Profile's pin controls to keep individual tools or a server's tools in the default catalog. Switching to Curated listing opens a picker for the initial pins. With no pinned tools, the catalog still contains the two meta tools. Unpinned tools remain searchable and callable, including by a previously cached exposed name; disabled or policy-blocked tools do not. You can switch back to Direct listing at any time.
Tool Risk Policy
Moor classifies tools as safe, write, destructive, or unknown using their names and descriptions. You can correct a classification on the server detail page.
Each Profile defaults to Advisory, which displays risk without blocking calls. Block destructive removes tools classified as destructive from listings and search results, and refuses calls with error code -32002 and a structured reason. The policy applies in both exposure modes and takes precedence over pins. It does not block write or unknown tools; the classification is a heuristic, not a guarantee of read-only access.
Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
Grok Build: ~/.grok/config.toml
Pi: ~/.pi/agent/mcp.json (requires pi install npm:pi-mcp-adapter)
Manual entry and pasted JSON batch import are also supported for stdio and HTTP/SSE servers.
Client Configuration
Generate ready-to-copy configuration snippets for Claude Code, Claude Desktop, Codex, OpenCode, Cursor, Kimi Code, dsh, Grok Build, and Pi. The snippets contain only the /mcp endpoint; Moor's X-Moor-Token is reserved for internal management API calls.
Audit Logs
With audit logging enabled (the default), tool calls are recorded with:
Timestamp, Profile, Server, Tool name
Arguments (with sensitive data redaction)
Result or error
Duration and Agent info
Call origin (direct or meta) and refusal reason when blocked
Filter by time range, server, or tool. View aggregate statistics on the Dashboard and policy-blocked call counts in Insights. Audit logging can be disabled in Settings → Advanced. Logs are retained for 30 days by default; set logRetentionDays to 0 to keep them indefinitely.
System Tray
By default, closing the window hides Moor in the macOS menu bar or Windows system tray while the gateway keeps running. Disable Minimize to Tray on Close in Settings to quit on window close, or use Quit Moor in the tray menu. Quitting stops the gateway.
Real-Time Status
Server status changes and Profile switches are pushed to the UI via SSE. No refresh needed.
MCP clients listening on GET /mcp receive notifications/tools/list_changed when the Profile, pins, risk policy, or tool catalog changes. Clients that handle this notification can fetch the updated catalog without reconnecting. Refresh tools on a running server from its detail page to repeat discovery without restarting the process.
AI Agent ──HTTP──▶ POST /mcp ──▶ Moor Gateway ──stdio/HTTP──▶ MCP Servers
│
WebView ──IPC──▶ get_sidecar_info ─┐
WebView ──env──▶ VITE_MOOR_API_URL/TOKEN ─┤ (fallback in browser dev mode)
WebView ──fetch──▶ /api/* ─────────┘
WebView ◀──SSE──── /api/events
Runtime discovery: WebView → Tauri IPC (get_sidecar_info) → Rust (port, token); in browser dev mode (pnpm dev) falls back to the VITE_MOOR_API_URL / VITE_MOOR_API_TOKEN env vars — see src/lib/api/runtime.ts (GET /api/runtime exists but is token-protected)
Business operations: WebView → HTTP fetch() → In-process Axum server (Rust)
Linux: .deb / .rpm / .AppImage under src-tauri/target/release/bundle/ (x86_64 + aarch64, built by CI)
Code Quality
vp check # format + lint + type check
vp lint # lint only
vp lint --fix # auto-fix
vp fmt # format
Testing
# Rust gateway tests
cargo test --manifest-path src-tauri/Cargo.toml
# Frontend + scripts tests
vp test
API
Management endpoints under /api/* require a loopback Host and the X-Moor-Token header. The /mcp endpoint follows the loopback/LAN rules described above and does not require that token.
MCP Gateway
Method
Path
Description
ALL
/mcp
MCP protocol endpoint (Streamable HTTP)
Server Management
Method
Path
Description
GET
/api/servers
List all servers
POST
/api/servers
Add server
GET
/api/servers/:id
Server detail
PUT
/api/servers/:id
Update server config
DELETE
/api/servers/:id
Remove server
POST
/api/servers/:id/start
Start server
POST
/api/servers/:id/stop
Stop server
GET
/api/servers/:id/tools
Get discovered tools (optionally filter by ?profile_id=)
POST
/api/servers/:id/tools/refresh
Rediscover tools on a running server without restarting it
PATCH
/api/servers/:id/tools/:toolName/risk
Override a tool's riskLevel
PUT
/api/servers/order
Reorder servers
Profile Management
Method
Path
Description
GET
/api/profiles
List all profiles
POST
/api/profiles
Create profile
GET
/api/profiles/:id
Get profile detail (with servers)
PUT
/api/profiles/:id
Update name, exposureMode, riskPolicy, or initialPins when entering Curated mode
DELETE
/api/profiles/:id
Delete profile
PUT
/api/profiles/:id/activate
Set as active profile
POST
/api/profiles/:id/clone
Clone a profile
GET
/api/profiles/:id/servers/:serverId
Get server toggle, disabled tools, and pinned tools
PUT
/api/profiles/:id/servers/:serverId
Update server toggle + disabled tools
PUT
/api/profiles/:id/servers-state
Bulk update server toggles, disabledTools, and pinnedTools
GET
/api/profiles/:id/tools
Profile tool groups with visibility, pin, and risk metadata
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Moor?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Moor precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Moor usa?
Moor roda localmente via stdio.
Quando Moor foi verificado pela última vez?
Última verificação: 2026-11-05. Moor is a local MCP control plane for Mac. It gives every coding agent one safe, observable, configurable gateway to your MCP servers.