# Serena-MCP

Serena-MCP is a self-hosted ai app. Serena is a Model Context Protocol (MCP) toolkit that gives AI coding agents IDE-level code intelligence. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3302/serena-mcp

## Description

Serena is a Model Context Protocol (MCP) toolkit that gives AI coding agents IDE-level code intelligence. It provides semantic code retrieval, editing, refactoring, and debugging powered by language servers, so agents can navigate definitions, references, and symbols across a codebase instead of relying on raw line numbers or text search. Serena works with any MCP-enabled client such as Claude and Claude Code and includes a web dashboard for monitoring and management. It is a strong fit for developers who want faster, more reliable agents in large or complex codebases.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

63/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 6 days ago)
- Popular: 90 (31,405 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 10 (3 serious findings, 13 minor, CI, tests)

## Security check

3 serious findings: Uses anyio 4.13.0, which has a known critical vulnerability; Uses gitpython 3.1.58, which has a known critical vulnerability; Uses pyjwt 2.13.0, which has a known critical vulnerability.
Automated checks on commit 8e1a255, 12 Oct 2026. Not an audit.

## Links

- Official website: https://oraios.github.io/serena
- GitHub: https://github.com/oraios/serena
- Unraid: https://ca.unraid.net/apps/serena-mcp-1ygcom30c2h3fb?q=Serena-MCP

## 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3302/serena-mcp), the self-hosted and open-source app directory.
