Self-host Serena-MCP
v2.1.0MCP server giving coding agents IDE-style code tools
docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena- Stars
- 31 391
- Ports
- 9121 (MCP server (HTTP/SSE transport)), 24282 (web dashboard)
ghcr.io/oraios/serenaWhat is Serena-MCP?
Serena hands AI coding agents the capabilities an IDE gives a human: symbol-level lookup, navigation to references and declarations, edits that operate on symbol bodies, renames and other refactors. It runs as a Model Context Protocol server, so any MCP-capable client can drive it, including terminal clients such as Claude Code, Codex or Gemini CLI, IDE assistants for VS Code, Cursor and JetBrains products, and desktop or web GUIs. Two interchangeable code-intelligence backends are available: free language servers covering more than forty programming languages, or a paid JetBrains plugin that borrows the IDE's analysis engine and adds move/inline refactorings, dependency search, type hierarchy and a REPL-style interactive debugger. Serena also keeps project memories for long-lived agent sessions, serves a local web dashboard for inspecting tool calls, logs and settings, and is tuned through layered YAML configuration (global file, per-project files, contexts and modes) plus command-line flags. v2 introduced a REPL agent interface in which the model calls Serena's API from Python instead of invoking one tool per action. Install it with uv as the serena-agent package and initialise it with serena init, or use the experimental image on GitHub Packages; note the server is stateful, so a single instance works on one coding project at a time. The application is licensed GPL-3.0-or-later, while its SolidLSP language-server component stays MIT.
Serena-MCP alternatives
CasibaseOpen-source personal AI assistant with RAG knowledge bases, MCP tool use and autonomous agent loops; one self-hosted binary with 30+ model providers, SSO and audit logs.CompareCasibase with Serena-MCP
DodaiosSelf-hosted open-source AI assistant for desktop and headless servers. Coordinates coding agents, voice control with wake word, 40+ tool integrations, all data local.CompareDodaios with Serena-MCP
LibreChatSelf-hosted open-source AI chat unifying OpenAI, Anthropic, Google, Azure, AWS, and local models with agents, code interpreter, artifacts, MCP, and enterprise auth.CompareLibreChat with Serena-MCP
ObservalSelf-hosted, open-source registry for coding agent Skills, MCP servers, hooks and Agents, with session traces, AI insights and review governance for dev teams.CompareObserval with Serena-MCP
remembraSelf-hosted AI memory server for coding agents to hand off sessions across machines and vendors. Captures git facts and transcripts for the next agent.Compareremembra with Serena-MCP
Agent Search MCPAn open-source MCP server that lets AI agents search the web in Chinese and English without API keys, returning traced evidence with built-in token limits.CompareAgent Search MCP with Serena-MCP
crowSelf-hosted agentic framework and MCP platform to build AI agents, connect clients like Claude Code as native MCP connectors, with persistent memory and P2P sharing.Comparecrow with Serena-MCP
PawFlow-AgentsPawFlow is an open-source, self-hosted AI agent runtime connecting agents to real files and desktops via relays with durable context and deterministic workflows.ComparePawFlow-Agents with Serena-MCP
Should you self-host Serena-MCP?
Serena-MCP scores 81/100 on selfhost.directory (how scoring works) and ranks #5 of 167 in Developer Tools. It has 31 391 GitHub stars, +1 202 in the last 30 days.
It shipped 15 stable releases in the past year. The latest, v2.1.0, came out on 19 October 2026. New versions land roughly every 6 days.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Other-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is openhands (87/100, 93 498 stars). It scores higher overall, so compare the two before you pick. See Serena-MCP vs openhands side by side.
Features
- File, regex search and shell toolsTypically disabled inside harnesses such as Claude Code or Codex.
- GUI log viewerDisabled by default; mainly Windows, unsupported on macOS.
- Interactive debuggingExclusive to the JetBrains plugin backend.
- Language server backend for 40+ languages
- MCP Server Integrationstdio is the default transport; streamable HTTP and legacy SSE are also supported.
- Multi-layered YAML configuration
- Project indexing and health check
- Project memory systemCan be disabled via the no-memories mode.
- Query external projectsEnabled through the query-projects mode.
- RefactoringMove, inline and propagation of deletions require the JetBrains plugin.
- REPL agent interfaceNew in Serena v2; selected via the agent_interface setting.
- Symbolic code editing
- Symbol-level code retrieval
- Web DashboardEnabled by default at http://localhost:24282/dashboard/index.html.
More in Developer Tools
sessySelf-hosted open-source dashboard for AWS SES email observability — track deliveries, bounces, opens, clicks, complaints without per-email markup.
sglangSGLang is an open-source, self-hosted inference framework for LLMs and multimodal models with OpenAI-compatible API.
shaiOpen-source terminal coding agent written in Rust, with an interactive TUI, headless piping, an OpenAI-compatible HTTP server, MCP tools and skills.
shell.onlineSelf-hosted terminal sharing for coding agents — run Claude Code on your computer, access live sessions from any browser with end-to-end encryption.
shelveOpen-source, self-hosted secrets manager for dev teams: keep API keys and .env values in an encrypted vault with team roles, activity logging, scoped tokens and a CLI.
ShieldsSelf-hosted Shields.io generates concise SVG and raster status badges for READMEs and web pages, covering hundreds of CI, registry and code-analysis services.
ShimmyA self-hosted, open-source LLM inference server: a single Rust binary that serves GGUF models through an OpenAI-compatible API, as an alternative to Ollama.
ShiroMailShiroMail is a self-hosted temporary email platform with real SMTP ingest, domain management, verification code extraction, and an admin console with API access.
shmSelf-Hosted Metrics (SHM) is an open-source telemetry server for self-hosted apps. Collects aggregate stats via cryptographic identities, stores in PostgreSQL.
SidecarSidecar is a self-hosted terminal workspace unifying AI coding agents, task management, git workflows, and file browsing in one interface with split panes.
signetaiSelf-hosted memory layer for AI agents. Captures transcripts, builds a knowledge graph via Dreaming, and lets you inspect every memory with full provenance.
SignToolsSignTools signs iOS apps without a computer. Web service plus macOS/CI builder for Apple signing. Upload unsigned apps, download signed versions, install via OTA on iOS.
0 comments