Openclaude
FreeNot checkedFastMCP 3.2 server plus Webapp for using the leaked Claude Code locally with ollama and open weight models. Kairos and cat included
About
FastMCP 3.2 server plus Webapp for using the leaked Claude Code locally with ollama and open weight models. Kairos and cat included
README
📖 Installation Guide — quick start, manual setup, and troubleshooting
A high-performance control plane for Ollama-based local LLM sessions, with background memory consolidation (KAIROS), hybrid cloud planning (ULTRAPLAN), and real-time fleet monitoring. Optimized for RTX 4090 environments.
Features
- Background Memory (KAIROS): Auto-consolidates session data into
MEMORY.mdusing asynchronous background cycles. Configurable poll interval and consolidation budget. State persists across restarts. - Session Management: Launch, prompt, monitor, and stop multiple OpenClaude subprocesses concurrently. Persistent across restarts with usage analytics (prompts, output chars, estimated tokens).
- Multimodal Input: Send images (png, jpeg, webp, gif) alongside text instructions via the
send_multimodaltool. Works with any vision-capable Ollama model. - Ollama Control Plane: Model management with VRAM/speed/context metadata, health checks, default persistence.
- Hybrid Planning (ULTRAPLAN): Optional cloud Opus/Sonnet handoff for complex reasoning, local execution. Token cost tracking included.
- Fleet Observability: React dashboard with real-time SSE push, xterm.js terminal, system log viewer, KAIROS status, interactive API playground.
- Interactive Examples: Live "Run" buttons on every example — calls the real backend, shows response JSON with timing.
- API Reference: Searchable documentation with parameter tables, return schemas, env vars, error codes for all 15 tools.
- Safety Guardrails: Kid-safe mode with content filters, proactive privacy reminders, caregiver alerts (file + webhook).
- Dual Transport: MCP SSE (Claude Desktop) + REST bridge (webapp/curl) on the same port.
Quick Start
git clone https://github.com/sandraschi/openclaude-mcp
cd openclaude-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:
.\setup.ps1
.\start.ps1
- SSE Endpoint:
http://localhost:10932/sse - Fleet Dashboard:
http://localhost:10933 - API Events:
http://localhost:10932/api/events(SSE push) - Health API:
http://localhost:10932/api/healthOr with Docker: docker compose up
Available Tools (15)
| Tool | Action |
|---|---|
start_session |
Initialize a new Ollama session |
send_prompt |
Execute a prompt in an active session |
send_multimodal |
Send text + images to a session (png, jpeg, webp, gif) |
session_status |
Get output/status/usage/elapsed of a session |
list_sessions |
List all active sessions |
stop_session |
Stop and clean up a session |
kairos_enable |
Activate background memory consolidation |
kairos_disable |
Halt background memory consolidation |
kairos_log |
Retrieve KAIROS consolidation log |
list_models |
Inventory of available Ollama models |
set_default_model |
Set default model for new sessions |
model_status |
Check VRAM and load status |
ultraplan |
Hybrid cloud/local planning cycle |
fleet_dashboard |
Prefab UI fleet status overview |
fleet_status |
Raw fleet status JSON |
caregiver_alert |
[KID-SAFE] Notify caregivers of high-risk interaction |
Architecture
┌─────────────────┐
│ Claude Desktop │── SSE ──────┐
│ Cursor / VSCode │ │
└─────────────────┘ │
▼
┌──────────────┐ REST ┌────────────────────────────┐ stdio (NDJSON) ┌──────────────────┐
│ React Webapp│───────►│ server.py (FastMCP 3.2) │◄────────────────│ OpenClaude CLI │
│ (SSE push) │◄───────│ + SessionStore │ subprocess │ (Node.js/Bun) │
└──────────────┘ │ + ModelRouter │◄───────────────►│ + Ollama :11434 │
│ + KairosController │ └──────────────────┘
│ + SessionPersistence │
│ + SSE Event Bus │
└────────────────────────────┘
Configuration (env vars)
| Variable | Default | Description |
|---|---|---|
OPENCLAUDE_MCP_PORT |
10932 |
Backend port |
OPENCLAUDE_MCP_TOKEN |
— | REST auth token (disable if unset) |
OPENCLAUDE_DIR |
D:\Dev\repos\external\openclaude |
OpenClaude source path |
OPENCLAUDE_ULTRAPLAN_MODEL |
claude-sonnet-4-6 |
Anthropic model for ULTRAPLAN |
OPENCLAUDE_CONFIG_DIR |
~/.config/openclaude |
Persistence directory |
KAIROS_POLL_SECONDS |
30 |
KAIROS daemon poll interval |
KAIROS_MAX_CONSOLIDATIONS |
100 |
Max consolidations per session |
CAREGIVER_WEBHOOK_URL |
— | Webhook for caregiver alerts |
Prerequisites
- Ollama (running locally)
- Node.js (v20+)
- Python 3.13+ with
uv - Local model pulled (e.g.,
gemma4:26b,qwen3.5:35b-a3b)
Test Suite
uv run pytest # 79 tests (unit + smoke + integration + e2e)
uv run pytest tests/unit/ # fast, no external deps
uv run pytest tests/e2e/ # Anthropic API mocked via respx
License
MIT
Installing Openclaude
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/sandraschi/openclaude-mcpFAQ
Is Openclaude MCP free?
Yes, Openclaude MCP is free — one-click install via Unyly at no cost.
Does Openclaude need an API key?
No, Openclaude runs without API keys or environment variables.
Is Openclaude hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Openclaude in Claude Desktop, Claude Code or Cursor?
Open Openclaude on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
by GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
by UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
by duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
by blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
by Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
by runapi-aiCompare Openclaude with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
