serena

环境要求

• 已安装 uv（Serena 由 uv 管理，这是唯一必需的前置条件）
• Python 3.13（安装命令中通过 -p 3.13 指定，由 uv 管理）
• 使用 language server 后端时，某些语言可能需要额外安装依赖
• 一个支持 MCP 的客户端（如 Claude Code、Codex、Claude Desktop 或支持 MCP 的 IDE）

安装与启动步骤

1. 1安装 uv

   Serena 由 uv 管理，安装 uv 是唯一必需的前置条件。具体安装方式请按官方 uv 安装文档操作，README 未给出命令。

2. 2安装 Serena

   用 uv 将 serena-agent 作为工具全局安装，并指定 Python 3.13。安装成功后 shell 中应能调用 serena 命令。

   uv tool install -p 3.13 serena-agent

   复制

3. 3初始化 Serena

   运行初始化并验证环境是否正常。默认使用 language server 后端，成功后会提示 Serena 已成功初始化。

   serena init

   复制

4. 4改用 JetBrains 后端

   默认后端为 language server；若想使用 JetBrains 后端，在初始化命令后追加 -b JetBrains 参数。

   serena init -b JetBrains

   复制

5. 5配置 MCP 客户端

   在你使用的 MCP 客户端中配置启动命令以连接 Serena。不同客户端的写法不同，需按官方 clients 文档操作。

如何确认成功

终端中 serena 命令可用，且执行 serena init 后收到初始化成功的提示信息。

常见问题

注意事项

• 严禁通过 MCP 市场或插件市场安装，其中的命令已过时。
• 使用 language server 后端时，部分编程语言需要额外安装依赖，详见官方语言支持页面。
• 官方建议阅读用户指南，尤其是基于项目的工作流（project-based workflow）和配置（configuration）两节。