Serena-MCP

Serena-MCP

Docker app from PikkonMG's Repository

Overview

Serena is a powerful MCP (Model Context Protocol) toolkit for coding agents. It provides semantic code retrieval and editing capabilities powered by language servers (LSP), giving your AI agent IDE-level code intelligence. Features: Semantic code navigation -find definitions, references, and symbols across your codebase Language server integration -supports Python, TypeScript, Go, Java, C/C++, PHP, and more MCP-compatible -works with Claude, Claude Code, and any MCP-enabled client Web dashboard -monitor and manage Serena via browser FIRST START SETUP (required for dashboard access): After the first start, edit /mnt/user/appdata/serena-mcp/config/serena_config.yml and change: web_dashboard_listen_address: 127.0.0.1 -> web_dashboard_listen_address: 0.0.0.0 Also set: gui_log_window: False web_dashboard_open_on_launch: False Then restart the container. This only needs to be done once. PROJECT MOUNTING: Each project must be mounted as its own volume. In the Unraid template UI, click "Add another Path" for each project: Host path: /mnt/user/your-project-folder Container path: /workspace/your-project-folder Repeat for each project you want Serena to access. Connect your MCP client to http://[IP]:9121/mcp (streamable-http transport). See DOCKER.md for full setup instructions: https://github.com/oraios/serena/blob/main/DOCKER.md

Runtime arguments

Web UI
http://[IP]:[PORT:24282]
Network
bridge
Shell
sh
Privileged
false

Template configuration

MCP Server PortPorttcp

Port for the Serena MCP server. Connect your MCP client to http://[IP]:[PORT]/mcp (streamable-http transport).

Target
9121
Default
9121
Value
9121
Dashboard PortPorttcp

Port for the Serena web dashboard.

Target
24282
Default
24282
Value
24282
Config DirectoryPathrw

Persistent storage for Serena config, memories, and project data. After first start, edit serena_config.yml here and set web_dashboard_listen_address to 0.0.0.0, then restart.

Target
/workspaces/serena/config/
Default
/mnt/user/appdata/serena-mcp/config/
Value
/mnt/user/appdata/serena-mcp/config/
Project DirectoryPathrw

Optional: select an existing project directory to mount into Serena. Leave blank to avoid creating a placeholder folder. For additional projects, add another Path with container path /workspace/[project-name]/.

Target
/workspace/project/
Serena Docker ModeVariable

Enables Docker-specific behavior in Serena. Keep set to 1.

Target
SERENA_DOCKER
Default
1
Value
1
Intelephense License KeyVariable

Optional: License key for Intelephense PHP language server premium features.

Target
INTELEPHENSE_LICENSE_KEY

Details

Repository
ghcr.io/oraios/serena
Last Updated2026-05-31
First Seen2026-04-22

Run Serena-MCP on Unraid.

Serena-MCP is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.