Serena MCP 配置教程

Serena 是一个强大的代码智能工具，提供 IDE 级别的语义代码检索和编辑能力，让 AI 助手能够像使用 IDE 一样操作代码。

功能特性

🔍 语义代码检索（find_symbol, find_referencing_symbols）
✏️ 精确代码编辑（insert_after_symbol, replace_symbol_body）
🌐 支持 30+ 编程语言
💡 大幅提升代码操作的 token 效率
🆓 完全免费开源

前置要求

需要先安装 uv（Python 包管理器）：

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

安装 Serena

方式一：使用 uv pip 安装（推荐）

uv pip install --system serena-agent

方式二：使用 uvx 运行

uvx --from git+https://github.com/oraios/serena serena start-mcp-server

MCP 配置

本地安装后配置

{
  "mcpServers": {
    "serena": {
      "command": "serena",
      "args": ["start-mcp-server"]
    }
  }
}

使用 uvx 配置

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena", "start-mcp-server"]
    }
  }
}

核心工具

工具	功能
`find_symbol`	查找代码符号（类、函数、变量等）
`find_referencing_symbols`	查找引用某符号的所有位置
`get_symbols_overview`	获取文件的符号概览
`replace_symbol_body`	替换符号的实现
`insert_after_symbol`	在符号后插入代码
`insert_before_symbol`	在符号前插入代码
`read_file`	读取文件内容
`search_for_pattern`	搜索代码模式