selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Serena-MCP logo

Self-host Serena-MCP

v2.1.0

MCP server giving coding agents IDE-style code tools

ReleaseOpen SourceOther
docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena
Updated3 weeks ago
LanguagePython
Setup difficultyEasy
Stars
31 391
Ports
9121 (MCP server (HTTP/SSE transport)), 24282 (web dashboard)
Docker
ghcr.io/oraios/serena

What is Serena-MCP?

Serena-MCP alternatives

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.

Serena-MCP README

The IDE for Your Coding Agent
discord license: GPL-3.0-or-later

How to install Serena-MCP

Install Serena-MCP with Docker

docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena 

Alternatively, adjust and run the compose file provided in the repository:

docker-compose up serena

Experimental; projects must be mounted as volumes and the image lacks dependencies for languages needing system-level installs.

How to configure Serena-MCP

  • GOOGLE_API_KEYEnvironment variable for a Google API key used by the container setup.
  • ANTHROPIC_API_KEYEnvironment variable for an Anthropic API key used by the container setup.
  • SERENA_PORTOverride the MCP server port used by the compose file (default 9121).
  • SERENA_DASHBOARD_PORTOverride the web dashboard port used by the compose file (default 24282).
  • SERENA_HOMEEnvironment variable that changes the location of the Serena user data directory (defaults to ~/.serena).

Serena-MCP releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Developer Tools

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…