serena

让 AI 像人翻书一样搜代码,改哪里一眼定位。

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 2135 🐛 待处理 154 👀 关注 92
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 31227
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

serena 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队oraios
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议NOASSERTION
主要语言Python
技术栈/模型agent,ai,ai-coding,claude,claude-code,codex,ide,jetbrains,language-server,mcp-server,programming,vibe-coding
GitHub 星标★ 31227
上线时间2025-03-23 00:00:00
代码更新2026-10-28
仓库体积13.4 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数6

项目介绍

功能强大的 MCP 编程工具包,为 AI Agent 提供语义检索与编辑能力,堪称智能体的 IDE。它能帮助代理精准定位代码、理解上下文并安全修改,让 AI 编程从盲猜升级为结构化协作。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 31227

使用教程

难度:入门 约 10 分钟 部署方式:命令行工具 5 步

环境要求

  • 已安装 uv(Serena 由 uv 管理,这是唯一必需的前置条件)
  • Python 3.13(安装命令中通过 -p 3.13 指定,由 uv 管理)
  • 使用 language server 后端时,某些语言可能需要额外安装依赖
  • 一个支持 MCP 的客户端(如 Claude Code、Codex、Claude Desktop 或支持 MCP 的 IDE)

安装与启动步骤

  1. 1安装 uv

    Serena 由 uv 管理,安装 uv 是唯一必需的前置条件。具体安装方式请按官方 uv 安装文档操作,README 未给出命令。

  2. 2安装 Serena

    用 uv 将 serena-agent 作为工具全局安装,并指定 Python 3.13。安装成功后 shell 中应能调用 serena 命令。

    uv tool install -p 3.13 serena-agent
  3. 3初始化 Serena

    运行初始化并验证环境是否正常。默认使用 language server 后端,成功后会提示 Serena 已成功初始化。

    serena init
  4. 4改用 JetBrains 后端

    默认后端为 language server;若想使用 JetBrains 后端,在初始化命令后追加 -b JetBrains 参数。

    serena init -b JetBrains
  5. 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···

★ 100 2026-08-09
AgentCrew 开源

让多个 AI 代理协作干活,一个终端搞定复杂任务

Chat application with multi-agents system supports multi-models and MCP

★ 225 2026-08-09
fastclaw 开源

用 Go 快速搭多智能体协作系统

Multi-Agent Framework

★ 1402 2026-09-13
llm-wiki-agent 开源

丢进资料,自动长出你的个人维基百科

A personal knowledge base that builds and maintains itself. Drop in sources — Claud···

★ 3686 2026-08-09
tinycortex 开源

给 AI 装一个本地快速记忆库,跨会话不忘事

The Fastest AI Memory Model - Your Second Brain

★ 269 2026-10-30
mue-x 开源

让 AI 自己改代码,越用越聪明

The first self-evolving AI agent. Rewrites its own source code in real-time. 6 AST m···

★ 281 2026-08-09
my-claude-devteam 开源

给 Claude Code 配一个 12 人虚拟工程团队,自动搞定需求到审查全流程

An engineering team in a box for Claude Code — 12 specialized agents, 15 automation···

★ 268 2026-08-09
a-evolve 开源

让智能体自己迭代变强,不用重训模型

The official repository of "Position: Agentic Evolution is the Path to Evolving LLMs···

★ 844 2026-11-07
ccpm 开源

多个 AI 同时开工互不打架,活干完自动汇报。

Project management skill system for Agents that uses GitHub Issues and Git worktrees···

★ 8437 2026-08-09