ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

如何在 JetBrains AI Assistant 中配置 Serena MCP 服务器

2026/9/13 10:34:35 拓冰建站 浏览量
如何在 JetBrains AI Assistant 中配置 Serena MCP 服务器 如何在 JetBrains AI Assistant 中配置 Serena MCP 服务器【免费下载链接】serenaA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent项目地址: https://gitcode.com/GitHub_Trending/ser/serena如果你想在 JetBrains IDE 的 AI Assistant 里使用 Serena 提供的符号检索与编辑能力需要把 Serena 配置为 AI Assistant 的 MCP 服务器。完成本文后AI Assistant 会像启动其他 stdio 类型 MCP 服务器一样在会话中自动拉起 Serena 进程并加载其工具集你不需要手动启动服务器。前提是本机已安装serena命令行工具下文给出安装方式且你的 IDE 已启用 AI Assistant 的 MCP 支持。前提条件安装并确认 Serena 可用Serena 由uv管理。确认本机已安装uv后执行uv tool install -p 3.13 serena-agent完成后serena命令应出现在终端 PATH 中。可以用serena --help或serena start-mcp-server --help快速验证命令可用并查看所有可用选项。文档中提供了两种后端初始化方式按你的语言智能后端需求二选一serena init使用默认的 language server 后端serena init -b JetBrains使用 JetBrains 插件作为后端需要另行安装 Serena JetBrains Plugin。后端随时可以通过 Serena 的配置切换安装阶段不必纠结。详见 安装文档。在 AI Assistant 的 MCP 设置中添加 Serena打开 IDE 的Settings / Tools / AI Assistant / MCP添加以下配置{ mcpServers: { serena: { command: serena, args: [ start-mcp-server, --contextjb-ai-assistant, --project-from-cwd ] } } }几个参数说明start-mcp-server以 stdio 模式启动 MCP 服务器。stdio 模式下服务器由客户端这里就是 AI Assistant作为子进程拉起你不需要自己启动它。--contextjb-ai-assistant指定运行上下文。Serena 的提示词会根据启用的上下文自动调整工具集jb-ai-assistant是专为 AI Assistant 提供的上下文可用serena context list查看内置上下文列表。--project-from-cwd从当前工作目录自动检测项目向上逐级查找包含.serena/project.yml或.git的最近目录并激活它。保存配置后AI Assistant 的 MCP 配置中就会出现serena这一条目。全局配置还是项目级配置与 JetBrains Junie 一样AI Assistant 同样支持在全局配置与项目级配置之间选择两者的权衡相同全局配置Serena 对所有项目可用但项目不会在 Serena 中自动激活每个会话开始时你可能需要提示 AI Assistant “Activate the current project using serenas activation tool”部分模型能够自动激活无需手动提示。项目级配置Serena 只在该项目中可用作为回报项目在启动时会被 Serena 自动识别为激活状态。如果你的日常使用集中在少数项目上项目级配置更省事如果你希望 Serena 出现在所有项目里选全局配置并接受手动激活的开销。验证配置是否生效Serena 默认会启动一个基于 Web 的 Dashboard用于检查服务器运行状态、日志和配置默认地址为http://localhost:24282/dashboard/index.html若默认端口被占用会换到更高端口。配置完成后触发一次 AI Assistant 会话如果 Dashboard 能正常打开并显示当前会话与配置信息说明客户端已成功拉起 Serena 服务器。更多 Dashboard 能力编辑配置、查看工具调用、关闭服务器等见 Dashboard 文档。此外文档建议养成定期打开 Dashboard 的习惯其中也会发布版本更新信息。常见问题客户端找不到serena命令。即使serena已在你系统 PATH 中客户端有时仍可能无法找到它。解决办法是在command字段中写serena可执行文件的完整路径而不是裸命令名。语言服务器需要额外环境变量。某些语言服务器要求显式设置环境变量文档示例macOS 上用 Homebrew 安装的 F#这类变量需要加到 MCP 服务器条目中。对于从 shell profile如.bashrc、.zshrc继承不到的变量直接在serena对象里加env键例如env: { DOTNET_ROOT: /opt/homebrew/Cellar/dotnet/9.0.8/libexec }可选切换为 JetBrains 插件后端如果你主要使用 JetBrains IDE文档推荐安装 Serena JetBrains Plugin 并让 Serena 以它为语言后端。该后端是 MCP 服务器的语言智能层不是面向用户的 UI 扩展——你仍然通过 AI Assistant 与 Serena 交互。配置方式任选其一serena init -b JetBrains或者手动编辑全局配置~/.serena/serena_config.ymlWindows 为%USERPROFILE%\.serena\serena_config.yml文件可能尚不存在language_backend: JetBrains也可以在每次启动时通过--language-backend JetBrains按实例覆盖或在项目.serena/project.yml中设置language_backend: JetBrains按项目覆盖。验证方式Dashboard 的配置概览中会显示Languages: Using JetBrains backend同时客户端会开始使用jet_brains_find_symbol等 JetBrains 专属工具。需要注意两点限制语言后端在服务器启动时确定运行中的会话无法切换若之后激活了使用不同后端的项目Serena 会返回错误。另外IDE 中打开的项目根目录必须与 Serena 激活的项目根目录一致。多模块项目建议用 monorepo 父目录或符号链接把各模块收拢到一个根目录并在 IDE 和 Serena 中同时打开它。下一步配置完成后即可在 AI Assistant 中直接使用 Serena 的工具。关于项目的创建、索引、激活等完整工作流以及首次会话的 onboarding记忆机制可继续阅读 项目工作流文档各参数与配置项的完整说明见 配置文档。【免费下载链接】serenaA powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent项目地址: https://gitcode.com/GitHub_Trending/ser/serena创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考