MCP 및 도구 호출

Serena: A Semantic Code Retrieval and Editing MCP Toolkit for AI Agents

oraios/serena

Serena is an MIT-licensed, Python-based MCP toolkit that provides AI coding agents with IDE-grade semantic code retrieval, editing, refactoring, and debugging capabilities through high-level symbol-level abstractions.

공식 저장소 열기 ↗ 프로젝트 홈페이지 ↗
★ 27.6K별점
⑂ 1.8K포크 수
107미해결 이슈
Python언어
MIT라이선스
Q@project.QualityScore편집 점수

프로젝트 스크린샷

Serena: A Semantic Code Retrieval and Editing MCP Toolkit for AI Agents 스크린샷 Serena: A Semantic Code Retrieval and Editing MCP Toolkit for AI Agents 스크린샷

개요

Serena acts as an IDE layer for coding agents, offering semantic code retrieval, editing, refactoring, and debugging tools that operate at the symbol level rather than relying on primitive line-number or text-search operations. It integrates with AI clients via the Model Context Protocol (MCP) and supports two backends: open-source language servers (LSP) supporting over 40 programming languages by default, and a paid JetBrains plugin that leverages JetBrains IDE analysis capabilities. Serena's agent-first design aims to make agents faster, more efficient, and more reliable, particularly on large and complex codebases.

주요 기능

  • Semantic code retrieval: find symbol, file outline, find referencing symbols, find declaration, find implementations, diagnostics
  • Refactoring: rename, move, inline, propagate deletions (JetBrains plugin only for move, inline, and propagate deletions)
  • Symbolic editing: replace symbol body, insert after/before symbol, safe delete
  • Interactive debugging with breakpoints and REPL-style execution control (JetBrains plugin only)
  • Memory management system for persistent, cross-session agent workflows
  • Multi-layered YAML configuration: global, CLI, per-project, execution context, and composable modes
  • Support for 40+ programming languages via LSP language servers
  • Basic utilities: regex search, text replacement, directory listing, file search, file reading, shell command execution
  • MCP server with launch command or HTTP mode connectivity

요구 사항, 설치 및 빠른 시작

Install Serena using uv with the command: `uv tool install -p 3.13 serena-agent`. After installation, the `serena` command should be available. The README explicitly warns against installing Serena via an MCP or plugin marketplace, as they contain outdated and suboptimal installation commands.

사용 정보

After installation, run `serena init` to initialise Serena and verify the setup. By default, this configures the language server backend; to use the JetBrains backend instead, add the parameter `-b JetBrains`. Then, configure your MCP client by providing it with a Serena launch command or an HTTP server URL. Specific client configuration instructions are available in the documentation.

모델 호환성 및 사용 사례

Serena is client and LLM agnostic, integrating via MCP. It is compatible with terminal-based clients (Claude Code, Codex, OpenCode, Gemini CLI), IDE plugins (Copilot, Junie, JetBrains AI Assistant for VSCode, Cursor, JetBrains IDEs), and desktop/web clients (Claude Desktop, Codex App, OpenWebUI).

라이선스 및 위험 참고 사항

Licensed under the MIT License.

Editorial verification 2026-08-09: repository URL, owner, description, license and repository statistics were reviewed. License metadata: MIT. README was fetched for the channel draft; re-check repository dependencies, releases and model terms before production use.

릴리스 및 유지 관리

Repository created on 2025-03-23. Last pushed on 2026-08-05. Default branch is main. The repository is not archived.

MemPalace

mempalace/mempalace

★ 58KPython

QwenPaw

agentscope-ai/qwenpaw

★ 33.9KPython

Composio

composiohq/composio

★ 29.5KTypeScript