세레나 MCP (Serena MCP)

Summary

IDE의 “Go to Definition” 수준 의미 기반(semantic) 코드 검색 기능을 Claude Code에 붙여주는 MCP 서버.

IDE의 “Go to Definition” 수준 의미 기반(semantic) 코드 검색 기능을 Claude Code에 붙여주는 MCP 서버.

핵심 기능

• 의미 기반 검색: grep의 텍스트 매칭 대신 코드의 의미·구조를 파악해 탐색
• 심볼 탐색: 함수·클래스·변수 정의 위치를 즉시 찾아줌
• 참조 추적: 특정 심볼이 어디에서 사용되는지 파악
• 일괄 rename: 리팩토링 시 rename 기능으로 다수 파일을 한 번에 변경
• 대시보드: 로컬 웹 대시보드에서 도구 사용 현황 확인

토큰 절약 메커니즘

불필요한 파일 탐색을 줄여 컨텍스트 팽창을 억제. 1회 검색 비용 절감보다는 대화가 길어질수록 커지는 누적 절약 효과가 핵심.

grep 기반: 키워드 → 변수명·주석·문자열 전체 검색 → 대량 토큰 소모
세레나: 코드 의미 파악 → 정의 위치만 정확히 탐색 → 토큰 절약

설치

• UV-Python패키지매니저 선행 설치 필수
• Claude Code에서 /plugin → 세레나 검색 → 설치
• 설치 후 /mcp → 세레나 MCP 선택 → Reconnect

참고

• Anthropic 공식 마켓플레이스 및 Claude 공식 문서에서 별도 소개할 만큼 권장 도구
• 자연어 요청 시 MCP가 동작하지 않으면 프롬프트에 “세레나 MCP 사용해서”처럼 명시

출처

• yt-L94yAQR9VvA-클로드코드-공식플러그인4개-토큰절약 (짐코딩, 2026-05)