Serena
Serveur MCP par Oraios AI
Offrir aux agents de code une récupération, une édition et une refactorisation sémantiques du code, comme dans un IDE, grâce aux serveurs de langage.
Installer Serena
Tourne sur votre machine. Votre client le lance avec cette commande :
Nécessite uv (Python) sur votre ordinateur. Les étapes ci-dessous montrent où placer la commande dans chaque client.
Partager ce serveur
Ouvre cette page, avec la commande d’installation et les étapes de configuration.
mcp.tc/i/serenaPrésentation
Serena ajoute à un client MCP des outils de code au niveau des symboles. Les agents peuvent trouver des symboles et des références, modifier du code et le refactoriser sur plusieurs fichiers, sans lire des fichiers entiers ni s’appuyer sur les numéros de ligne. Il inclut aussi un système de mémoire pour les workflows d’agent de longue durée.
Il s’exécute en local via stdio, lancé avec uvx à partir du paquet PyPI serena-agent. Par défaut, il utilise des serveurs de langage (plus de 40 langages listés dans le README). Un plugin JetBrains payant, optionnel, peut servir de backend à la place. Aucune clé API n’est documentée pour le serveur lui-même.
Ce que vous pouvez faire
- Récupérer le code au niveau des symboles, références comprises
- Modifier le code par symbole plutôt que par numéro de ligne
- Refactoriser sur plusieurs fichiers, par exemple renommages et déplacements
- Travailler avec plus de 40 langages via des serveurs de langage
- Utiliser éventuellement le plugin JetBrains comme backend
- Conserver la mémoire de l’agent pour les workflows de longue durée
Outils
Les serveurs locaux présentent leurs outils une fois lancés, et celui-ci ne publie pas sa liste à l’avance. Votre client les affiche après l’ajout.
Exemples de prompts
Trouve toutes les références à la fonction processOrder dans ce projet.
Renomme la classe UserService et mets à jour chaque utilisation dans tous les fichiers.
Montre-moi l’aperçu des symboles de src/api/client.py.
Remplace le corps de la fonction parse_config par cette nouvelle version.
Configuration
Chaque client lance Serena sur votre machine avec la même commande. Choisissez le vôtre ; la page retient votre choix.
Claude Code
- Lancez ceci dans un terminal, dans le dossier de votre projet :
claude mcp add --transport stdio serena -- uvx -p 3.13 --from serena-agent serena start-mcp-server --context claude-code --project-from-cwd- Démarrez Claude Code et tapez
/mcp. serena devrait apparaître comme connecté.
Ajoutez --scope user pour le rendre disponible dans tous vos projets.
Claude Desktop
- Ouvrez Settings → Developer → Edit Config. Cela ouvre
claude_desktop_config.json. Ajoutez :
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"--from",
"serena-agent",
"serena",
"start-mcp-server",
"--context",
"claude-code",
"--project-from-cwd"
]
}
}
}- Enregistrez le fichier et redémarrez Claude Desktop.
Nécessite uv (Python) sur votre ordinateur. Le fichier se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
Cursor
Ajouter à Cursor (s’ouvre dans un nouvel onglet)
Ou ajoutez-le à la main dans ~/.cursor/mcp.json (tous les projets) ou .cursor/mcp.json (ce projet) :
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"--from",
"serena-agent",
"serena",
"start-mcp-server",
"--context",
"claude-code",
"--project-from-cwd"
]
}
}
}Nécessite uv (Python) sur votre ordinateur.
VS Code
Installer dans VS Code (s’ouvre dans un nouvel onglet)
Ou depuis un terminal :
code --add-mcp '{"name":"serena","type":"stdio","command":"uvx","args":["-p","3.13","--from","serena-agent","serena","start-mcp-server","--context","claude-code","--project-from-cwd"]}'Ou committez-le dans le dépôt, dans .vscode/mcp.json :
{
"servers": {
"serena": {
"type": "stdio",
"command": "uvx",
"args": [
"-p",
"3.13",
"--from",
"serena-agent",
"serena",
"start-mcp-server",
"--context",
"claude-code",
"--project-from-cwd"
]
}
}
}Nécessite uv (Python) sur votre ordinateur.
Devin Desktop
- Ajoutez-le à
~/.config/devin/mcp_config.json(macOS et Linux) ou%APPDATA%\devin\mcp_config.json(Windows) :
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"--from",
"serena-agent",
"serena",
"start-mcp-server",
"--context",
"claude-code",
"--project-from-cwd"
]
}
}
}- Actualisez la liste des serveurs MCP dans Cascade.
Devin Desktop est le nouveau nom de Windsurf.
Codex
codex mcp add serena -- uvx -p 3.13 --from serena-agent serena start-mcp-server --context claude-code --project-from-cwdOu modifiez directement ~/.codex/config.toml :
[mcp_servers.serena]
command = "uvx"
args = ["-p", "3.13", "--from", "serena-agent", "serena", "start-mcp-server", "--context", "claude-code", "--project-from-cwd"]Nécessite uv (Python) sur votre ordinateur.
Gemini CLI
gemini mcp add serena uvx -- -p 3.13 --from serena-agent serena start-mcp-server --context claude-code --project-from-cwdCela l’ajoute au projet en cours. Ajoutez -s user pour l’utiliser partout.
Tout client
La plupart des clients qui lancent des serveurs locaux acceptent cette forme :
{
"mcpServers": {
"serena": {
"command": "uvx",
"args": [
"-p",
"3.13",
"--from",
"serena-agent",
"serena",
"start-mcp-server",
"--context",
"claude-code",
"--project-from-cwd"
]
}
}
}Zed place les serveurs sous context_servers dans ses réglages, avec les mêmes champs command, args et env.
Nécessite uv (Python) sur votre ordinateur.
FAQ
Puis-je coller mcp.tc/i/serena dans mon client MCP ?
Non. Serena tourne sur votre propre ordinateur, lancé par votre client, il n’a donc pas d’adresse web à laquelle se connecter. Le lien rapide est la page à partager ; la commande d’installation est uvx -p 3.13 --from serena-agent serena start-mcp-server --context claude-code --project-from-cwd.
Serena a-t-il besoin d’une clé API ?
Non. Il ne déclare ni clé ni variable d’environnement. Il s’exécute avec les droits de votre compte utilisateur, vérifiez donc ce que ses outils peuvent atteindre.
Serena est-il un serveur distant ou local ?
Local. Votre client le lance comme un processus sur votre ordinateur avec uvx -p 3.13 --from serena-agent serena start-mcp-server --context claude-code --project-from-cwd, qui nécessite uv (Python).
Que peut faire Serena ?
Vous pouvez récupérer le code au niveau des symboles, références comprises, modifier le code par symbole plutôt que par numéro de ligne et refactoriser sur plusieurs fichiers, par exemple renommages et déplacements.
Quels clients peuvent l’utiliser ?
Tout client qui lance des serveurs locaux : Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed et d’autres. claude.ai et ChatGPT ne se connectent qu’à des serveurs distants.
Qui a rédigé cette page ?
Le robot de mcp.tc a lu les métadonnées publiques de Serena (ses pages de paquet et de dépôt), et un modèle d’IA en a tiré le texte. Une personne examine tout ce que les vérifications ne peuvent pas confirmer. Le texte peut encore contenir des erreurs : si vous en repérez une, utilisez Signaler cette fiche sur cette page. Cette traduction a été réalisée par un modèle d’IA à partir du texte anglais.
Intégrer
Affichez Serena dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise la commande d’installation du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations
Badge pour README
[](https://mcp.tc/i/serena)<a href="https://mcp.tc/i/serena"><img src="https://mcp.tc/i/serena/badge.svg" alt="Serena on mcp.tc" height="20"></a>Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.
Carte pour site web
<script src="https://mcp.tc/w/serena.js" async></script>La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.
iframe
<iframe src="https://mcp.tc/embed/serena" title="Serena on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.
JSON
La fiche sous forme de données pour vos pages et vos outils : nom, accroche, commande d’installation, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).
https://mcp.tc/i/serena.jsonmcp.tc n’est pas affilié à Oraios AI. Cette page a été construite à partir des métadonnées publiques de Serena, vérifiées pour la dernière fois le 3 oct. 2026, et un modèle d’IA a rédigé la description : elle peut contenir des erreurs. Les noms et marques appartiennent à leurs propriétaires. Quelque chose cloche ? Signaler cette fiche. La traduction a été réalisée par un modèle d’IA à partir du texte anglais.