项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 31227
技术标签
使用教程
环境要求
- 已安装 uv(Serena 由 uv 管理,这是唯一必需的前置条件)
- Python 3.13(安装命令中通过 -p 3.13 指定,由 uv 管理)
- 使用 language server 后端时,某些语言可能需要额外安装依赖
- 一个支持 MCP 的客户端(如 Claude Code、Codex、Claude Desktop 或支持 MCP 的 IDE)
安装与启动步骤
-
1安装 uv
Serena 由 uv 管理,安装 uv 是唯一必需的前置条件。具体安装方式请按官方 uv 安装文档操作,README 未给出命令。
-
2安装 Serena
用 uv 将 serena-agent 作为工具全局安装,并指定 Python 3.13。安装成功后 shell 中应能调用 serena 命令。
uv tool install -p 3.13 serena-agent -
3初始化 Serena
运行初始化并验证环境是否正常。默认使用 language server 后端,成功后会提示 Serena 已成功初始化。
serena init -
4改用 JetBrains 后端
默认后端为 language server;若想使用 JetBrains 后端,在初始化命令后追加 -b JetBrains 参数。
serena init -b JetBrains -
5配置 MCP 客户端
在你使用的 MCP 客户端中配置启动命令以连接 Serena。不同客户端的写法不同,需按官方 clients 文档操作。
如何确认成功
终端中 serena 命令可用,且执行 serena init 后收到初始化成功的提示信息。
常见问题
Q:能从 MCP 市场或插件市场安装 Serena 吗?
A:不可以。官方明确警告这些市场中的安装命令已过时且并非最优,应按照 Quick Start 的 uv 安装步骤操作。
Q:uv 该怎么安装?
A:README 未给出具体命令,只说明安装 uv 是唯一前置条件,请参考 uv 官方的安装文档(docs.astral.sh/uv)完成安装。
Q:如何切换成 JetBrains 后端?
A:在初始化时加参数即可:serena init -b JetBrains,更多用法见官方 JetBrains 插件文档页面。
Q:怎么把 Serena 接到我的 MCP 客户端?
A:需要在你所用客户端中配置一个启动命令,官方 clients 文档分别给出了 Claude Code、Codex、Claude Desktop 及各类 MCP IDE 的配置方式。
注意事项
- 严禁通过 MCP 市场或插件市场安装,其中的命令已过时。
- 使用 language server 后端时,部分编程语言需要额外安装依赖,详见官方语言支持页面。
- 官方建议阅读用户指南,尤其是基于项目的工作流(project-based workflow)和配置(configuration)两节。
核心亮点
- 基于MCP协议提供语义检索与代码编辑能力,为AI编码代理提供类似IDE的上下文感知操作,显著提升agent在大型代码库中的导航和修改效率。
- 支持Claude Code、Codex、JetBrains等多种主流AI编码工具和IDE,集成方式灵活,适配性强。
- Python实现,技术栈清晰,便于开发者二次开发和扩展,且项目星标近2.8万,社区活跃度高。
不足之处
- 文档/社区待观察
- 作为MCP工具集,依赖外部AI编码工具配合使用,单独使用价值有限,且对非MCP生态的开发者上手门槛较高。
适用场景
- 大型代码库的语义检索与精准定位,辅助AI代理快速理解项目结构。
- 在Claude Code、Codex等AI编程工具中,为agent提供实时代码编辑和重构能力。
- 作为IDE插件或语言服务器的补充,增强开发环境的智能代码导航和操作。
替代项目
Continue、Aider、Cline
上一篇:ruflo
下一篇:claude-context
同类项目推荐
sub-agents-skills
开源
一个技能,调度所有主流AI编码助手,按任务选最优模型
Cross-LLM sub-agent orchestration as an Agent Skills. Route tasks to Codex, Claude C···
AgentCrew
开源
让多个 AI 代理协作干活,一个终端搞定复杂任务
Chat application with multi-agents system supports multi-models and MCP
fastclaw
开源
用 Go 快速搭多智能体协作系统
Multi-Agent Framework
llm-wiki-agent
开源
丢进资料,自动长出你的个人维基百科
A personal knowledge base that builds and maintains itself. Drop in sources — Claud···
tinycortex
开源
给 AI 装一个本地快速记忆库,跨会话不忘事
The Fastest AI Memory Model - Your Second Brain
mue-x
开源
让 AI 自己改代码,越用越聪明
The first self-evolving AI agent. Rewrites its own source code in real-time. 6 AST m···
my-claude-devteam
开源
给 Claude Code 配一个 12 人虚拟工程团队,自动搞定需求到审查全流程
An engineering team in a box for Claude Code — 12 specialized agents, 15 automation···
a-evolve
开源
让智能体自己迭代变强,不用重训模型
The official repository of "Position: Agentic Evolution is the Path to Evolving LLMs···
ccpm
开源
多个 AI 同时开工互不打架,活干完自动汇报。
Project management skill system for Agents that uses GitHub Issues and Git worktrees···
