Serena-MCP
Serena is a Model Context Protocol (MCP) toolkit that gives AI coding agents IDE-level code intelligence.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
63/100 Good
- Maintained
- 100last commit 6 days ago
- Popular
- 9031,405 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 304 GB minimum RAM
- Security check
- 103 serious findings, 13 minor, CI, tests
Security check: 3 serious findings
- Uses anyio 4.13.0, which has a known critical vulnerability (PyPI)
- Uses gitpython 3.1.58, which has a known critical vulnerability (PyPI)
- Uses pyjwt 2.13.0, which has a known critical vulnerability (PyPI)
Automated checks on commit 8e1a255, 12 Oct 2026. Not an audit.
Availability: platform listings confirmed today, links checked 18 days ago
- GitHub stars
- 31,405
- Open issues
- 158
- Last commit
- 2026-11-15
- Latest release
- v2.1.0
- Activity
- declining
Checked 6 days ago - source: GitHub (oraios/serena)
Resources & Compatibility
Minimum requirements: 4 GB RAM.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Install Serena with uv First make sure uv (a fast Python package installer) is installed, then run: uv tool install -p 3.13 serena-agent. Without this main Serena program installed, none of the other Serena commands or tools will work. source
- Initialize Serena's code tools After installation, run: serena init so Serena sets up the default language-server backend. If you skip this, Serena's code analysis setup may be missing and features that understand your code can fail. source
- Create and index your project Run: serena project create --index to make a new Serena project and build its file index at the same time. If you don't do this, Serena won't have the project data it needs to find and work with your code. source
- Enable web dashboard access (one-time setup) On first start, to allow dashboard access from outside the container, edit /mnt/user/appdata/serena-mcp/config/serena_config.yml: change web_dashboard_listen_address from 127.0.0.1 to 0.0.0.0, and set gui_log_window: False and web_dashboard_open_on_launch: False. Then restart the container. This is a one-time setup. source
Fetched 48 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
What must I do after installing Serena-MCP for code analysis to work?
Install the main Serena program with uv and run serena init. This sets up the default language-server backend, and skipping it can leave code analysis features broken.
How do I make Serena index a codebase?
Run serena project create --index to create the project and build its file index at the same time. Without this step Serena does not have the project data it needs to find and work with code.
How do I connect Serena to an MCP client?
Add a custom MCP server entry in your MCP-enabled client and specify a run command that starts Serena. Any MCP-enabled client can be used this way.
How can I keep Serena running on a Linux host?
Run it under nohup, tmux, or systemd. If the uv or uvx commands are not found, fix your PATH.
Answers sourced from betelgeuse.work, oraios.github.io, oraios.github.io, oraios.github.io
Community
- Reddit (reddit)
- In Cursor, is there really a need for Serena/Sequential Thinking/Exa ... (forum)
- [SUPPORT] Serena MCP Server - Docker Containers - Unraid (forum)
Collected 49 days ago - public community threads