Serena 最佳实践方案

1. 全局安装 Serena

你需要用 包名 serena-agent 来安装，但安装完后命令行工具叫 serena：

uv tool install --from git+https://github.com/oraios/serena serena-agent

安装成功后，全局会有一个可执行命令：

serena --help

后续操作

升级：

uv tool upgrade serena-agent

卸载：

uv tool uninstall serena-agent

2. MCP 客户端配置

✅ Codex CLI 配置（Linux/Mac 路径示例）

编辑 ~/.codex/config.toml：

[mcp_servers.serena]
command = "serena"
args = ["start-mcp-server", "--context", "codex", "--project", "."]


说明：
command = "serena" → 使用全局安装的命令。
--project . → 默认绑定到当前目录，你也可以改成绝对路径。

✅ Claude Code / Claude Desktop 配置

运行命令一次即可：

claude mcp add serena -- serena start-mcp-server --context ide-assistant --project .

说明：
--project . → 始终服务于当前目录。

如果你有多个项目，可以在不同项目目录下重复执行这条命令。

✅ Gemini CLI 配置

# 编辑 ~/.config/gemini/settings.json（或项目下 .gemini/settings.json）：
{
  "mcpServers": {
    "serena": {
      "displayName": "Serena Coding Agent",
      "command": "serena",
      "args": [
        "start-mcp-server",
        "--context",
        "ide-assistant",
        "--project",
        "."
      ]
    }
  }
}

3. 使用方式

在项目目录下：

codex   # 或 claude / gemini

然后直接在 CLI 中对话，比如：
“帮我找出所有 UserService 的调用位置”
“重构这个函数，提取公共逻辑”
CLI 会自动调用 Serena（因为 MCP 已注册），Serena 会基于当前项目目录执行操作。

4. 日常建议

保持全局一份安装：更新时执行

uv tool upgrade serena

跨 CLI 配置一致：三个 CLI 都用 command = "serena"，不用 uvx --from。

多项目支持：
默认用 --project .（当前目录），
特殊情况手动改路径即可。

✅ 总结：
安装一次 → 全局 serena 命令可用。
所有 CLI 配置都指向这个命令。
项目切换靠 --project 参数，一般用 . 即可。