SEMANTIC CODE TOOLS / Oraios
Serena MCP
Gives coding assistants symbol-aware navigation, editing and refactoring through language-server or JetBrains backends.
“Serena”
01 / THE REASONING
Why this made the selection.
- Offers project-aware semantic operations instead of relying entirely on text search and line offsets.
- Tool registration marks edit-capable operations as destructive, exposing a useful permission distinction.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md (installation, capability and permission sections)
- pyproject.toml
- src/serena/mcp.py
- LICENSE
Our findings
- The MCP entrypoint supports stdio, SSE and Streamable HTTP and sets annotations from tool edit capabilities.
- The current quick start installs serena-agent, initializes the backend, then directs the user to client-specific launch guidance.
Not established by this review
- Server startup, authentication and tool execution were not tested.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
uv tool install -p 3.13 serena-agentCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- Run the documented serena init step after installation.
- Choose the supported backend and follow the linked client configuration guide for the MCP launch command.
Before you start
- uv and any language-server dependencies required by the project’s languages.
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Official documentation ↗Checked
https://github.com/oraios/serena/blob/8833e5e87363afaa1608f9347f5ad6adf7066b0f/README.md
Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports
- Applicable source licence ↗Checked
https://github.com/oraios/serena/blob/8833e5e87363afaa1608f9347f5ad6adf7066b0f/LICENSE
Supports: license
https://github.com/oraios/serena/blob/8833e5e87363afaa1608f9347f5ad6adf7066b0f/pyproject.toml
Supports: language, review
https://github.com/oraios/serena/blob/8833e5e87363afaa1608f9347f5ad6adf7066b0f/src/serena/mcp.py
Supports: language, review