CLI, MCP 서버, 데스크톱 앱으로 Codex, Claude Code, OpenCode 같은 AI 코딩 에이전트에 지속적인 프로젝트 지식을 제공하는 개인 컨텍스트 저장소입니다.
oraios/serena
코딩 에이전트에 IDE 수준의 심볼 검색, 의미 기반 편집 및 리팩터링을 제공하는 MCP 서버입니다.
대체할 수 있는 제품:JetBrains AI Assistant
- 스타
- 30,379
- 포크
- 2,232
- 열린 이슈
- 101
- 마지막 커밋
- 5일 전
어떤 프로젝트인가요?
Serena는 Model Context Protocol(MCP)을 통해 AI 코딩 에이전트와 연결되는 툴킷으로, 줄 번호와 일반 텍스트 검색에 의존하는 대신 함수, 해당 함수의 참조나 구현을 찾는 등 심볼 단위로 작업하는 도구를 제공합니다. Claude Code, Codex, Claude Desktop 같은 클라이언트와 VS Code, Cursor, JetBrains용 IDE 어시스턴트 플러그인에서 사용할 수 있습니다.
Serena는 두 가지 백엔드를 제공합니다. 기본적으로는 Language Server Protocol을 구현한 언어 서버를 사용해 40개 이상의 언어를 지원합니다. 또는 유료 JetBrains 플러그인을 사용하면 JetBrains IDE의 분석 및 리팩터링 엔진을 활용할 수 있으며, 코드 이동, 인라인 처리, 안전한 삭제 작업과 대화형 디버깅 도구도 제공됩니다.
프로젝트에는 에이전트 세션 간 지식을 공유하는 메모리 시스템과 YAML로 작성된 설정 계층도 포함되어 있습니다. 설정은 전역, 실행 명령별, 프로젝트별 또는 클라이언트별로 적용할 수 있습니다.
핵심 기능
- 01코드베이스 전반에서 심볼, 참조 및 구현을 찾습니다.
- 02줄 번호를 지정해 편집하지 않고도 심볼 본문을 교체하거나 앞뒤에 내용을 삽입합니다.
- 03여러 파일에 걸친 참조를 갱신하면서 심볼 이름을 변경합니다.
- 04언어 서버를 통해 40개 이상의 언어를 지원합니다.
- 05선택 사항인 JetBrains 플러그인으로 코드 이동, 인라인 처리 및 대화형 디버깅 기능을 추가합니다.
활용 사례
- 대규모 멀티파일 프로젝트에서 코딩 에이전트가 코드를 안전하게 이름 변경하거나 이동하도록 합니다.
- 여러 언어를 사용하는 모노레포에서 에이전트가 정확하게 코드를 탐색하도록 지원합니다.
- 내장 메모리 시스템으로 에이전트 세션 간 지식을 유지합니다.
빠른 시작
- 1
uv를 설치합니다(필수 사전 요구 사항은 이것뿐입니다).
- 2
uv를 통해 Serena를 설치합니다.
uv tool install -p 3.13 serena-agent - 3
Serena를 초기화하고 설정을 확인합니다.
serena init - 4
MCP 클라이언트에서 실행 명령을 구성합니다(클라이언트 가이드 참고).
사용 전 알아둘 점
- JetBrains 백엔드에는 유료 플러그인이 필요하지만 무료 체험을 이용할 수 있습니다.
- 일부 언어의 language server는 추가 종속성을 별도로 설치해야 합니다.
- 배지에는 라이선스가 GPL-3.0-or-later로 표시되어 있지만 메타데이터에는 NOASSERTION으로 나와 있으므로 상업적으로 사용하기 전에 확인하세요.
토픽
자주 묻는 질문
- serena은(는) 무엇인가요?
- 코딩 에이전트에 IDE 수준의 심볼 검색, 의미 기반 편집 및 리팩터링을 제공하는 MCP 서버입니다. Serena는 Model Context Protocol(MCP)을 통해 AI 코딩 에이전트와 연결되는 툴킷으로, 줄 번호와 일반 텍스트 검색에 의존하는 대신 함수, 해당 함수의 참조나 구현을 찾는 등 심볼 단위로 작업하는 도구를 제공합니다. Claude Code, Codex, Claude Desktop 같은 클라이언트와 VS Code, Cursor, JetBrains용 IDE 어시스턴트 플러그인에서 사용할 수 있습니다.
- serena은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- serena은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- serena은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. serena의 마지막 커밋은 2026년 10월 15일입니다.
- serena은(는) 어디에 사용할 수 있나요?
- 대규모 멀티파일 프로젝트에서 코딩 에이전트가 코드를 안전하게 이름 변경하거나 이동하도록 합니다. 여러 언어를 사용하는 모노레포에서 에이전트가 정확하게 코드를 탐색하도록 지원합니다. 내장 메모리 시스템으로 에이전트 세션 간 지식을 유지합니다.
- serena는 어떻게 설치하나요?
- uv를 설치합니다(필수 사전 요구 사항은 이것뿐입니다). uv를 통해 Serena를 설치합니다.: uv tool install -p 3.13 serena-agent Serena를 초기화하고 설정을 확인합니다.: serena init MCP 클라이언트에서 실행 명령을 구성합니다(클라이언트 가이드 참고).
- serena은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/oraios/serena
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
MCP와 CLI로 AI 코딩 도구에 정확한 리뷰 맥락을 제공하는 로컬 코드 지식 그래프입니다.
비개발자와 개발자가 아이디어 구상부터 출시까지 AI의 도움을 받아 실제 제품을 만들도록 안내하는 실습형 Vibe Coding 강의입니다.
코딩 에이전트의 세션 활동을 기록하고 AI로 압축한 뒤, 이후 세션에 관련 컨텍스트를 제공하는 지속성 메모리입니다.
AI 코딩 에이전트의 원시 도구 출력을 컨텍스트 창에서 제외하고 압축 후에도 세션 상태를 유지하는 MCP 서버입니다.
코드베이스를 스캔해 AI 코딩 도우미가 프로젝트를 탐색하는 데 쓰는 토큰을 줄여 주는 간결한 컨텍스트 파일을 생성하는 CLI입니다.