安装 uv 与 Serena：tool install + serena init

你将得到什么

• 本机可用的 serena CLI（通过 uv tool install 安装的 serena-agent）
• 一次成功的 serena init，默认启用 Language Server（LSP） 后端
• 清楚「先装 uv → 再装 Serena → 再接到 MCP 客户端」的官方顺序

开始前准备

1. 终端可访问外网（拉 PyPI / GitHub 资源）。
2. 尚无装 uv 时，先装 uv（下一节）。
3. 官方提醒：用语言服务器后端时，个别语言可能还需额外依赖；详见 Language Support。本课主路径用默认 LSP，不装 JetBrains 付费插件。

核心事实（先记住）

步骤 1：安装 uv（唯一硬前置）

官方 Installation 写明：Serena 由 uv 管理；若尚未安装，先按 uv Getting Started · Installation 装好。

常见 macOS / Linux 安装（以 Astral 文档当前推荐为准）：

curl -LsSf https://astral.sh/uv/install.sh | sh

装完后新开一个终端（或按安装脚本提示 source 环境），核对：

uv --version

对照结果：能打印出版本号（例如 uv 0.x.x）。若提示 command not found，把 uv 的 bin 目录加入 PATH 后再试。

Windows 请按 uv 官方文档使用 PowerShell 安装脚本；本课命令以 Unix shell 为主。

步骤 2：用 uv 安装 Serena

官方安装命令（指定 Python 3.13）：

uv tool install -p 3.13 serena-agent

对照结果：命令正常结束，无报错。接着核对 CLI：

serena --help

对照结果：应看到 Serena 的子命令帮助（含 init、start-mcp-server、setup 等）。若客户端稍后报「找不到 serena」，按官方 Clients 文档：可在 MCP 配置里写 serena 可执行文件的绝对路径。

哪天要升级到最新版：

uv tool upgrade serena-agent

步骤 3：初始化（默认语言服务器后端）

官方：用下列之一验证安装并完成初始化——

• serena init：默认 language servers 后端
• serena init -b JetBrains：改用 JetBrains 插件后端（需另装插件；本课不强制）

本课跟做默认路径：

serena init

对照结果：终端出现初始化成功一类提示（官方称应收到 success message）。之后可随时在配置里切换后端，不必重装。

可选：若你主要在 IntelliJ / PyCharm 等 JetBrains IDE 里工作，再阅读 JetBrains Plugin 后再执行 serena init -b JetBrains。

步骤 4：知道下一步要做什么（本课不展开配置细节）

安装与 init 完成后，Serena 还不会自动出现在 Cursor / Claude Code 里——你需要按 Connecting Your MCP Client 把启动命令或 HTTP URL 写进客户端。那是第 2 课。

官方还建议尽快阅读：

• Project-based workflow
• Configuring Serena

常见问题（官方要点）

1. 从 MCP 市场一键装？ 官方 README 用 Important 强调：不要走市场；跟 Quick Start / Installation，避免过时命令。
2. 某语言找不到依赖？ 先查 Language Support；不少依赖会由 Serena 按需安装，少数需本机预装。
3. 想卸干净？ uv tool uninstall serena-agent。

本课检查清单

• uv --version 有输出
• uv tool install -p 3.13 serena-agent 成功
• serena --help 可用
• serena init 成功（默认 LSP）

完成后进入第 2 课：把 Serena 接到 Claude Code 与 Cursor。