oraios/serena

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

Serena – AI 코딩 에이전트를 위한 IDE 스타일 툴킷

정의 – Serena는 대규모 언어 모델 에이전트에 IDE 수준의 기능(기호 인식 코드 검색, 파일 간 리팩토링, 안전한 편집, (JetBrains 플러그인을 통한) 대화형 디버깅)을 제공하는 서버 측 "도구 상자"입니다. 자체 LLM을 포함하지 않으며, Model Context Protocol (MCP)을 지원하는 모든 클라이언트(예: Claude Code, Codex CLI, VS Code AI 어시스턴트 등)와 통신합니다.

중요성 – 현재 에이전트는 종종 원시 텍스트를 조작하므로 대규모 변경이 취약할 수 있습니다. Serena는 에이전트를 기호 수준으로 끌어올려 선언, 참조, 계층 구조를 이해하고 인간 개발자처럼 원자적 리팩토링을 수행할 수 있게 합니다. README에 따르면 Serena를 사용하는 에이전트는 일반적인 작업의 단계 수를 8~12개 줄이고 "더 날카롭고 차분함"을 느낍니다.

핵심 기능

카테고리	기능
검색	기호 찾기, 기호 개요 가져오기, 참조 찾기, 외부 프로젝트 쿼리, 진단 – 모두 기호 수준에서.
리팩토링	기호 전용 이름 변경(LSP), JetBrains 플러그인을 통한 전체 이름 변경/이동/인라인/삭제.
기호 편집	기호 본문 교체, 기호 앞/뒤에 삽입, 안전한 삭제 – 정규식 해킹 없이.
디버깅 (JetBrains 전용)	REPL 스타일 중단점 설정, 변수 검사, 표현식 평가.
기본 유틸리티	정규식 검색, 바꾸기, 디렉터리/파일 목록, 파일 읽기, 셸 명령 실행.
메모리 시스템	에이전트가 세션 간에 정보를 기억할 수 있는 간단한 영구 저장소.
구성 가능	YAML 기반 구성 레이어(전역, 프로젝트별, 클라이언트별, 동적 조각).
백엔드	• 언어 서버 모드 – 모든 LSP 서버 사용(40개 이상의 언어 지원). • JetBrains 플러그인 – JetBrains IDE의 전체 분석 엔진 활용(유료, 무료 평가판 제공).

작동 방식

설치 – Python 중심 패키지 관리자 uv를 사용하여 serena-agent 도구를 설치합니다(uv tool install -p 3.13 serena-agent).
serena init을 실행하여 MCP 서버(기본 LSP 백엔드)를 시작하거나 serena init -b JetBrains로 JetBrains 플러그인을 사용합니다.
AI 클라이언트(Claude Code, Codex, VS Code AI 확장 등)를 구성하여 MCP 서버를 시작하거나 가리킵니다. 클라이언트는 도구 사용 요청을 Serena에 보내고, Serena는 의미론적 작업을 수행하고 결과를 반환합니다.
에이전트는 이러한 도구를 연결하여(예: 기호 찾기 → 이름 변경 → 커밋) 복잡한 개발 워크플로를 완료할 수 있습니다.

대상 사용자

에이전트형 코딩 어시스턴트를 구축하는 개발자 – 안정적이고 기호 인식 작업이 필요한 경우.
LLM 기반 코드 생성 파이프라인을 평가하는 연구자 – Serena는 실험을 위한 재현 가능한 "IDE 레이어"를 제공합니다.
대규모 모노레포를 보유한 팀 – 파일 간 리팩토링 및 종속성 탐색이 일반적인 경우.

빠른 시작(README에서)

# 1. uv 설치(아직 없는 경우)
# 2. Serena 설치
uv tool install -p 3.13 serena-agent

# 3. 서버 초기화(기본 LSP 백엔드)
serena init

# 4. 사용자 가이드에 따라 MCP 지원 클라이언트를 서버에 연결합니다.

LSP 백엔드를 사용할 때 추가 언어별 종속성이 필요할 수 있습니다.

문서 및 커뮤니티

전체 문서 – https://oraios.github.io/serena/
Discord – https://discord.com/invite/cVUNQmnV4r(지원 및 토론)
비디오 소개 – README의 YouTube 링크.

라이선스

코어 SolidLSP 구성 요소 – MIT.
Serena 애플리케이션의 나머지 – GPL-3.0-or-later(결합 배포에는 GPL).
기여에는 CLA 서명이 필요합니다.

결론 – Serena는 AI 코딩 에이전트에 IDE급 기호 수준 도구를 제공하여 대규모 자동 코드 조작을 실용적이고 안정적으로 만드는 진정한 오픈소스 프로젝트입니다.