Serena 入门：uv 安装 MCP、初始化并接到 Claude Code / Cursor
按 Serena 官方 Installation 与 Connecting Your MCP Client：用 uv tool install 装 serena-agent，serena init 初始化；再分别接入 Claude Code（serena setup / claude mcp add）与 Cursor（ide context），验证符号级检索与重构工具可用。
入门·2 课时·45 分钟·图文实操
免费学习无需登录
你将学会
- 用 uv tool install -p 3.13 serena-agent 装好 CLI，并执行 serena init 完成默认 LSP 后端初始化
- 用 serena setup claude-code 或 claude mcp add 把 Serena 接到 Claude Code，并用 /mcp 核对连接
- 在 Cursor 的 mcp.json 用 --context ide 启动 Serena，并在 Agent 对话中激活项目、试用符号检索
适合谁
- 已在用 Claude Code / Cursor / Codex 等 MCP 客户端、想给 Agent 加 IDE 级符号能力的开发者
- 会终端与 JSON 配置，跟得上官方 Quick Start 与 Clients 文档的中文用户
- 维护中大型代码库、希望 Agent 做可靠重命名/引用查找而不是全文瞎搜的工程师
课前准备
- 本机可安装 uv（Astral）；官方要求用 uv 管理 Serena
- 至少一个 MCP 客户端：Claude Code、Cursor，或 Codex / Claude Desktop 等
- 建议从某个真实项目目录启动客户端（尤其使用 --project-from-cwd 时勿从家目录乱启）
课程目录
2 课时 · 45 分钟- 01安装 uv 与 Serena：tool install + serena init按官方 Installation：装好 uv，执行 uv tool install -p 3.13 serena-agent，再 serena init（默认 LSP 后端）验证 CLI 可用。图文20 分钟开始本课
- 02接入客户端：Claude Code 与 Cursor ide context按官方 Clients 文档：Claude Code 用 serena setup / claude mcp add；Cursor 等 IDE 用 --context ide 写 mcp.json；验证工具出现并做首轮符号查询。图文25 分钟开始本课
课程说明
本课按 Serena 官方 Installation 与 Connecting Your MCP Client 整理：用 uv tool install -p 3.13 serena-agent 安装，serena init 初始化默认语言服务器后端；再接入 Claude Code（serena setup claude-code / claude mcp add）与 Cursor（官方推荐 --context ide）。全程可复制命令与 JSON；勿从 MCP 市场安装过时命令。素材整理自官方文档与 README Quick Start，非二手洗稿。