oraios/serena
MCP toolkit providing semantic code retrieval and editing for coding agents.
Tested on LinuxKnown vulnerabilities
Use it
Before you install: known vulnerabilities
pickfit found 16 known high or critical vulnerabilities in the packages a fresh install brings (OSV.dev, 5 Nov 2026). Weigh this before you install it.
pypi:cryptography 46.0.6Vulnerable OpenSSL included in cryptography wheels (GHSA-537c-gmf6-5ccf, high, fixed in 48.0.1)pypi:filelock 3.25.2filelock ReadWriteLock: SQLite reopens the lock database by name, so a planted symlink or journal file makes the lock user's process overwrite or unlink its own files (GHSA-v4x8-3wr5-3wq8, high, fixed in 4.2.1)
See 8 more
pypi:cryptography 46.0.6— GHSA-g6cj-pr64-35w5 (high), fixed in 50.0.0pypi:cryptography 46.0.6— GHSA-jwv3-5hgf-82ww (high), fixed in 49.0.0pypi:mcp 1.26.0— GHSA-hvrp-rf83-w775 (high), fixed in 1.27.2pypi:mcp 1.26.0— GHSA-jpw9-pfvf-9f58 (high), fixed in 1.27.2pypi:mcp 1.26.0— GHSA-vj7q-gjh5-988w (high), fixed in 1.28.1pypi:python-multipart 0.0.22— GHSA-5rvq-cxj2-64vf (high), fixed in 0.0.30pypi:python-multipart 0.0.22— GHSA-pp6c-gr5w-3c5g (high), fixed in 0.0.27pypi:serena-agent 1.0.0— GHSA-37h2-6p4f-mp3q (high), fixed in 1.5.2
6 more findings not listed here.
Linux x86_64
You need first
- System packages:
uv
install serena-agent via uv tool install -p 3.13
uv tool install -p 3.13 serena-agent 2>&1
Where the README and reality differ
- README: serena-agent tools require only activate_project without session
What worked: activate_project requires both project* and session* arguments
Check that it works
serena --help 2>&1 | head -n 100; echo "---VERSION---"; serena --version 2>&1The output should contain “Usage: serena”.
First thing to try
serena init 2>&1Add it to your agent
claude mcp add serena -- serena start-mcp-server --project-from-cwdJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"serena": {
"command": "serena",
"args": [
"start-mcp-server",
"--project-from-cwd"
]
}
}
}What it does
- Semantic code retrieval and editingNot tested
- Find referencing symbolsNot tested
- Rename symbolsNot shown working
- Interactive debugging with breakpointsNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 4 Nov 2026
- Version 2.1.0
An MCP client handshake over stdio listed 3 tools, and a call to initial_instructions returned a result.