Serena
코딩 에이전트에게 심볼 단위 코드 탐색과 편집 도구를 제공하는 오픈소스 MCP 툴킷
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- MCP · 로컬 stdio
- 인증
- 공식 문서에서 권한 범위 확인
- 비용
- 서버는 무료 공개, 연결 서비스 비용은 별도 확인
- 제공 상태
- 공개 제공
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
전체 파일을 읽지 않고 선언·참조·호출 관계를 찾아 안전한 수정 범위를 정하기 어려운 업무
- 어떤 어려움인가
- 큰 코드베이스를 심볼 단위로 탐색하는 개발팀이 자주 마주치는 문제입니다. 구체적으로는 '전체 파일을 읽지 않고 선언·참조·호출 관계를 찾아 안전한 수정 범위를 정하기 어려운 업무' 상황입니다.
- 이렇게 해결합니다
- Serena 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '저장소 루트, 심볼 이름, 변경 목적과 제외 경로'입니다. 필요한 필드만 골라 '선언·호출자·수정 후보가 연결된 코드 영향도 표' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 Serena 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '선언·호출자·수정 후보가 연결된 코드 영향도 표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위저장소 루트, 심볼 이름, 변경 목적과 제외 경로업무 조건
- 02 · 현재 자료SerenaMCP 도구 호출: 입력 범위는 '저장소 루트, 심볼 이름, 변경 목적과 제외 경로'입니다. 필요한 필드만 골라 '선언·호출자·수정 후보가 연결된 코드 영향도 표' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '선언·호출자·수정 후보가 연결된 코드 영향도 표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과선언·호출자·수정 후보가 연결된 코드 영향도 표
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
선언·호출자·수정 후보가 연결된 코드 영향도 표을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '전체 파일을 읽지 않고 선언·참조·호출 관계를 찾아 안전한 수정 범위를 정하기 어려운 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- Serena 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '저장소 루트, 심볼 이름, 변경 목적과 제외 경로'입니다. 필요한 필드만 골라 '선언·호출자·수정 후보가 연결된 코드 영향도 표' 형태로 정리합니다. 다음 단계인 Figma MCP Server에서는 '디자인 노드와 에셋·구현 위치가 연결된 작업 브리프' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- Serena의 결과에는 원문 식별자와 처리 시각을 붙여 Figma MCP Server로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '선언·호출자·수정 후보가 연결된 코드 영향도 표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '디자인 노드와 에셋·구현 위치가 연결된 작업 브리프'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력저장소 루트, 심볼 이름, 변경 목적과 제외 경로정리된 입력
- 02 · 현재 자료Serena선언·호출자·수정 후보가 연결된 코드 영향도 표근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
전체 파일을 읽지 않고 선언·참조·호출 관계를 찾아 안전한 수정 범위를 정하기 어려운 업무를 반복 운영해야 할 때
- 어떤 어려움인가
- '전체 파일을 읽지 않고 선언·참조·호출 관계를 찾아 안전한 수정 범위를 정하기 어려운 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- Serena 단계에서는 허용한 도구와 권한 범위 안에서 필요한 작업만 호출합니다. 입력 범위는 '저장소 루트, 심볼 이름, 변경 목적과 제외 경로'입니다. 필요한 필드만 골라 '선언·호출자·수정 후보가 연결된 코드 영향도 표' 형태로 정리합니다. 보강은 Figma MCP Server, 전달과 후속 처리는 Skill: Frontend Design로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 Serena → Figma MCP Server → Skill: Frontend Design 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '선언·호출자·수정 후보가 연결된 코드 영향도 표'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력저장소 루트, 심볼 이름, 변경 목적과 제외 경로과 작업 ID작업 요청
- 자동 처리02 · 현재 자료Serena선언·호출자·수정 후보가 연결된 코드 영향도 표1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
연결
uv tool install -p 3.13 serena-agentSerena는 코딩 에이전트를 위한 IDE를 표방하는 MCP 툴킷입니다. 파일을 통째로 읽는 대신 심볼 수준에서 동작하며 코드의 관계 구조를 활용해 검색과 편집, 리팩터링, 디버깅을 수행합니다.
주요 기능
- 검색 도구: 심볼 찾기, 파일 개요 확인, 참조 추적, 타입 계층 조회, 진단 실행을 지원합니다
- 심볼 편집 도구: 심볼 본문 교체, 심볼 앞뒤 삽입, 안전한 삭제를 제공합니다
- 리팩터링 도구: 이름 변경, 심볼과 파일·디렉터리 이동, 인라인화, 미사용 코드 삭제 전파를 다루며 일부 기능은 JetBrains 백엔드 전용입니다
- 메모리 관리: 세션과 프로젝트를 넘어 지식을 유지하며 원하지 않으면 비활성화할 수 있습니다
의미 분석 백엔드는 두 가지 중 선택합니다. 기본값인 언어 서버(LSP) 방식은 오픈소스이며 40개 이상의 프로그래밍 언어를 지원하고, 별도의 JetBrains 플러그인은 유료(무료 체험 제공)로 IntelliJ 계열 IDE의 분석 기능과 중단점 설정·변수 검사 같은 대화형 디버깅을 활용합니다. 필수 준비물은 uv 설치뿐이며 `uv tool install -p 3.13 serena-agent` 이후 `serena init`으로 초기화합니다. 설정은 전역·CLI·프로젝트·컨텍스트 단위의 YAML 계층으로 조정합니다.
대규모 코드베이스에서 에이전트가 파일 전체를 훑는 대신 정확한 심볼만 다루게 하려는 개발자에게 적합합니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.