← 返回目录

Serena MCP: the IDE for your agent

社区

为编码智能体提供 IDE 级语义代码能力

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 158 / 438
Stars: ★ 30.4k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.13 · 预编译二进制
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 11 天前
工具数: 6

57FMRS · C

MIT 许可的开源编码 MCP 工具包，重点是语义代码检索、编辑和重构。manifest 明确提供 PyPI 包 serena-agent 与 stdio 启动方式；具体工具能力取决于所选语言服务器或 JetBrains 后端。

最强项 · 文档质量 14/20 最弱项 · 安全与权限 8/20

可靠性

9/20

安全与权限

8/20

维护活跃度

14/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: Manifest 声明了可复现的 PyPI 包、版本、stdio 传输和 uvx 启动参数，README 也说明了 MCP 连接方式与能力范围，因此启动和握手在 happy path 上是可信的。但提供的材料没有 CI、提交记录、已提交测试或 MCP 初始化/工具列表测试；语言服务器及额外语言依赖也可能导致运行时差异，因此按静态校准扣分，不能超过 12 分。
安全与权限 8/20: 材料未显示凭据窃取、隐蔽外传或默认远程访问；工具设计以当前项目为中心，并可配置禁用基础工具。但 README 明确包含文件读写、正则替换、符号重构和 execute_shell_command 等高影响能力，未提供默认确认机制、权限边界、沙箱策略、数据流说明或危险操作审计证据，因此无法视为最小权限，扣分。
维护活跃度 14/20: 仓库未归档，提供 MIT 许可证、明确的 GitHub 归属、当前版本 1.5.3 和开放问题信息，显示出维护与发布基础。材料没有提交/发布频率、依赖更新策略、漏洞响应流程或安全联系方式，故不能给满分。
文档质量 14/20: README 覆盖了产品定位、后端差异、支持语言、能力限制、安装前提、初始化、客户端接入和用户指南链接，且披露了部分语言服务器与 JetBrains 功能差异。但缺少可审查的完整工具参数/返回值示例、错误处理、故障排查、认证/网络边界、成本与平台兼容细节，仍有重要假设。
安装易用性 12/20: README 给出了 uv、Python 3.13、serena init 和客户端配置的总体路径，manifest 还提供了 uvx 的启动参数，因此主流程较清楚。但没有实际客户端配置样例，且语言服务器可能需要额外依赖、JetBrains 后端涉及付费插件，跨平台和故障处理步骤不充分，安装仍可能较手工。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

需要 IDE 级代码理解的编码智能体
大型或复杂的多文件项目
使用支持 MCP 的终端客户端、桌面客户端或 IDE 的开发者

不适合谁

非编码任务
只需简单文本编辑的小型任务
不希望授予项目代码编辑或 Shell 执行能力的环境

所需权限

需要访问项目文件以进行代码检索和编辑。
启用基础工具时，execute_shell_command 可运行构建、测试和代码检查等 Shell 命令。
语言服务器后端可能需要安装特定编程语言的额外依赖。
使用 JetBrains 后端需要 Serena JetBrains 插件；该插件为付费插件并提供免费试用。

风险与副作用

符号编辑、重构和文本替换可能修改或删除代码。
启用 Shell 工具后，智能体可能运行构建、测试、代码检查或其他命令。
不同语言的语言服务器支持和能力存在差异。
JetBrains 后端不支持 Rider 和 CLion。

安装接入

准备工作

运行环境：Python 3.13 · 预编译二进制

先安装 uv，然后使用 uvx 启动 PyPI 包 serena-agent，并指定 Python 3.13。通过客户端配置 stdio 启动命令；可使用 --project-from-cwd 指定当前项目，并通过 --context 选择执行上下文。首次使用运行 serena init 完成初始化。

.mcp.json

{"mcpServers":{"serena":{"command":"uvx","args":["-p","3.13","serena-agent","start-mcp-server","--project-from-cwd","--context","desktop-app"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "serena": {
      "command": "uvx",
      "args": [
        "-p",
        "3.13",
        "serena-agent",
        "start-mcp-server",
        "--project-from-cwd",
        "--context",
        "desktop-app"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add serena -- uvx -p 3.13 serena-agent start-mcp-server --project-from-cwd --context desktop-app

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

运行 serena init 确认初始化成功；然后在 MCP 客户端中检查 serena 服务器的工具列表是否出现 search_for_pattern、read_file 等工具，并让它执行一次 read_file 验证连接。

常见排障

确认已安装 uv。
确认启动命令使用 Python 3.13 和 serena-agent。
运行 serena init 验证初始化是否成功。
检查目标语言所需的语言服务器依赖。
检查客户端的 MCP 启动命令配置，以及 --project-from-cwd 和 --context 参数。
若需要更强的代码分析或调试能力，检查是否已选择并正确配置 JetBrains 后端。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在整个代码库中用正则搜索所有调用 execute_shell_command 的位置并给我列出文件和行号
阅读 src/config.py 并总结其中的主要配置类
把 utils.py 中 parse_args 函数的函数体替换为新实现，保留签名
在项目根目录运行测试套件并报告失败的测试

工具能力 6

search_for_pattern 只读

在代码库中执行灵活的正则表达式搜索。

replace_content 写入

执行面向智能体优化的正则表达式或字面文本替换。

list_dir 只读

列出目录内容。

find_file 只读

在项目中查找文件。

read_file 只读

读取文件或文件片段。

execute_shell_command 破坏性

执行 Shell 命令，例如构建、测试和代码检查。

使用场景

在大型代码库中按符号和关系检索代码

执行符号级编辑、重命名和安全删除

使用语言服务器或 JetBrains 后端辅助重构

在启用 JetBrains 插件后进行交互式调试

为长期智能体工作流管理记忆

支持客户端

Claude Code

Codex

OpenCode

Gemini CLI

VS Code

Cursor

Claude Desktop

Open WebUI

JetBrains IDEs

依据项目文档列出，未经本站实测。

详细介绍

Serena 是一个通过 MCP 提供语义代码检索、编辑、重构和调试能力的编码工具包。它基于语言服务器或 Serena JetBrains 插件，以符号和代码关系为中心辅助智能体处理复杂代码库。

同仓库的其他 Server

源版本 d9e4c796fae0 数据同步于 2026-10-19 查看 FMRS 评分方法