본문으로 건너뛰기
MCP 서버 전체 목록

Serena

  • 추천0
  • GitHub 별31K
  • 개발라이선스Other

에이전트용 IDE. 심볼 검색 · 참조 찾기 · 이름 바꾸기 · 심볼 단위 편집을 의미 기반으로 해 큰 코드베이스를 빠르게 다뤄요

원본:oraios/serena

설치 방법은 설치 탭에 정리했어요.

설명

Serena

코딩 에이전트를 위한 IDE

discord license: GPL-3.0-or-later

  • Serena는 IDE와 비슷한 시맨틱 코드 검색 · 편집 · 리팩터링 · 디버깅 도구를 제공해요. 심볼 단위로 동작하고 코드의 관계 구조를 활용해요.
  • 모델 컨텍스트 프로토콜(MCP)로 어떤 클라이언트나 LLM과도 연결돼요.

Serena의 에이전트 우선 도구 설계는 견고한 상위 추상화를 쓰기 때문에, 줄 번호나 원시적인 검색 패턴 같은 낮은 수준의 개념에 기대는 방식과 달라요.

실제로는 에이전트가 더 빠르고, 더 효율적이고, 더 믿을 수 있게 일한다는 뜻이에요. 크고 복잡한 코드베이스일수록 그래요.

💡 팁 새로운 REPL 기반 에이전트 인터페이스를 갖춘 Serena v2가 나왔어요. 새 인터페이스에 대한 더 알아보기와 설정 방법을 보세요.

영상

Serena 소개 영상

우리의 "최종 사용자"가 하는 말

Serena를 내려받아 설정하는 건 사람이지만, 최종 사용자는 사실상 AI 에이전트예요. Serena의 도구를 실제로 쓰는 쪽이라서 Serena를 가장 잘 평가할 수 있어요.

우리는 편향되지 않은 평가 프롬프트를 만들어, 에이전트가 일상적인 개발 작업을 대표하는 약 20개의 일반 코딩 작업을 하게 했어요. 에이전트가 기본으로 가진 도구와 함께 Serena의 도구를 썼을 때 더해지는 가치를 가늠하려는 거예요.

에이전트들이 한 말을 한 문장으로 요약하면 이래요.

큰 Python 코드베이스에서 Claude Code로 쓴 Opus 4.6 (high):

"Serena의 IDE 기반 시맨틱 도구는 내 도구 상자에 들어온 것 중 가장 영향이 큰 추가예요. 여러 파일에 걸친 이름 바꾸기, 이동, 참조 찾기는 내가 조심스럽고 실수하기 쉬운 8~12단계를 거쳐야 하는데, 이게 한 번의 원자적 호출로 줄어들어요. 같이 일하는 개발자에게는 꼭 설치하라고 부탁할 거예요."

Java 코드베이스에서 Codex CLI로 쓴 GPT 5.4 (high):

"코딩 AI 에이전트로서, 내 주인에게 Serena를 추가해 달라고 부탁할 거예요. 심볼 · 참조 · 리팩터링에 대한 IDE 수준의 이해라는, 내게 빠져 있던 것을 주거든요. 의미가 중요한 곳에서 불안한 텍스트 수술을 더 차분하고 빠르고 자신 있는 코드 변경으로 바꿔 줘요."

크고 여러 언어가 섞인 모노레포에서 Copilot CLI로 쓴 GPT 5.4 (medium):

"코딩 에이전트로서, 내 주인에게 Serena를 추가해 달라고 꼭 부탁할 거예요. 실제 코드에서 눈에 띄게 더 날카롭고 차분해지거든요. 특히 심볼을 아는 탐색, 여러 파일에 걸친 리팩터링, 모노레포의 의존성 점프가 그래요. 아주 작은 텍스트 편집이나 코드가 아닌 일에는 여전히 기본 도구에 기대지만요."

서로 다른 환경의 서로 다른 에이전트들이 같은 결론에 이르러요.

에이전트가 바라던 도구를 주세요. 클라이언트에 Serena MCP를 추가하세요!

평가 방법 전체와 훨씬 자세한 결과는 문서에 있어요. 원하는 프로젝트로 직접 평가를 돌려 볼 수도 있어요.

Serena가 일하는 방식

Serena는 코딩 작업에 필요한 도구를 제공하지만, 도구를 조율하며 실제 일을 하는 건 LLM이에요.

Serena는 **모델 컨텍스트 프로토콜(MCP)**로 지금 쓰는 AI 클라이언트의 기능을 넓혀 줘요. 요즘 AI 채팅 클라이언트는 대부분 MCP를 직접 지원해요.

  • Claude Code, Codex, OpenCode, Gemini-CLI 같은 터미널 클라이언트
  • VSCode, Cursor, JetBrains IDE용 IDE와 IDE 어시스턴트 플러그인(Copilot, Junie, JetBrains AI Assistant 등)
  • Claude Desktop, Codex App, OpenWebUI 같은 데스크톱 · 웹 클라이언트

Serena 구조도

📺 함께 보기: 5분 만에 보는 Serena 소개 (YouTube)

Serena MCP 서버를 클라이언트에 연결하는 방법은 두 가지예요.

  • 클라이언트가 MCP 서버를 시작할 수 있게 실행 명령을 알려 준다.
  • Serena MCP 서버를 직접 HTTP 모드로 시작하고 클라이언트에 URL을 알려 준다.

시작하는 방법은 아래 빠른 시작 절을 보세요.

프로그래밍 언어 지원과 시맨틱 분석 기능

Serena는 코드를 심볼 수준으로 이해해서 다양한 코드 조회 · 편집 기능을 제공해요. 이 기능을 갖춘 에이전트는 IDE의 기능을 쓰는 숙련된 개발자처럼 코드를 찾고 고쳐요. 아주 크고 복잡한 프로젝트에서도 알맞은 맥락을 효율적으로 찾아 제대로 처리해요!

이 기능을 뒷받침하는 기술은 두 가지 중 하나예요.

  • 언어 서버: 언어 서버 프로토콜(LSP)을 구현한 무료 · 오픈소스 방식이에요. 기본값이에요.
  • Serena JetBrains 플러그인: JetBrains IDE의 강력한 코드 분석 · 편집 기능을 활용해요(유료 플러그인, 무료 체험 있음).

취향과 요구에 맞게 둘 중 하나를 고르면 돼요.

언어 서버

Serena에는 언어 서버 프로토콜(LSP)을 구현한 언어 서버를 연결하는 강력한 추상화 계층이 있어요. 바탕이 되는 언어 서버는 보통 오픈소스 프로젝트이거나 적어도 무료로 쓸 수 있어요.

Serena의 언어 서버 백엔드를 쓰면 40개가 넘는 프로그래밍 언어를 지원해요. 아래가 그 목록이에요. Ada / SPARK, AL, Angular, Ansible, Astro, Bash, BSL, C#, C/C++, Clojure, Crystal, CUE, Dart, Deno, Elixir, Elm, Erlang, Fortran, F#, GDScript, Gleam, GLSL, Go, GraphQL, Groovy, Haskell, Haxe, HLSL, HTML, Java, JavaScript, JSON, Julia, Kotlin, LaTeX, Lean 4, Lua, Luau, Markdown, MATLAB, mSL, Nextflow, Nix, OCaml, Pascal, Perl, PHP, PowerShell, Python, QML, R, Rego, Ruby, Rust, Scala, SCSS / Sass / CSS, Solidity, Svelte, Swift, SystemVerilog, Terraform, TOML, TypeScript, VB.NET, Vue, WGSL, Wolfram Language, YAML, Zig.

Serena JetBrains 플러그인

유료 Serena JetBrains 플러그인(무료 체험 있음)은 JetBrains IDE의 강력한 코드 분석 기능을 활용해요. 이 플러그인은 JetBrains IDE가 지원하는 모든 프로그래밍 언어와 프레임워크를 자연스럽게 지원해요. IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, RubyMine, GoLand가 포함되고, 그 밖의 IDE도 될 수 있어요(Rider와 CLion은 지원하지 않아요).

JetBrains Marketplace

자세한 내용과 적용 방법은 문서 페이지를 보세요.

기능

Serena는 효율적인 코드 검색 · 편집 · 리팩터링을 위한 폭넓은 도구와, 오래 이어지는 에이전트 작업을 위한 기억(메모리) 시스템을 제공해요.

범위가 넓은 만큼, 여러 층으로 된 설정 시스템으로 필요에 맞게 조절할 수 있어요.

검색

Serena의 검색 도구로 에이전트는 파일 전체를 읽지 않고도 코드베이스를 심볼 수준에서 탐색하고 구조와 관계를 이해해요.

기능언어 서버JetBrains 플러그인
심볼 찾기예예
심볼 개요(파일 윤곽)예예
참조하는 심볼 찾기예예
프로젝트 의존성 안에서 검색--예
타입 계층--예
선언 찾기예*예
구현 찾기예**예
외부 프로젝트 조회예예
진단 · 검사예예

*: 외부 의존성 안의 선언에는 보통 동작하지 않아요.

**: 일부 언어에서만 되고, 언어 서버의 기능에 제한돼요.

리팩터링

정확한 리팩터링 도구가 없으면 에이전트는 믿을 수 없고 비싼 검색 후 바꾸기를 할 수밖에 없어요.

기능언어 서버JetBrains 플러그인
이름 바꾸기예(심볼만)예(심볼, 파일, 디렉터리)
이동(심볼, 파일, 디렉터리)--예
인라인--예
삭제 전파(안 쓰는 코드 제거)--예

심볼 단위 편집

Serena의 심볼 단위 편집 도구는 흔한 대안보다 오류가 적고 토큰도 훨씬 적게 써요.

기능언어 서버JetBrains 플러그인
심볼 본문 교체예예
심볼 뒤에 삽입예예
심볼 앞에 삽입예예
안전한 삭제예예

대화형 디버깅

JetBrains 플러그인에서만 되는 기능이에요. Serena는 아주 범용적인 디버깅 도구를 지원해요. 에이전트가 지속되는 REPL 방식 인터페이스로 중단점을 걸고, 변수를 살펴보고, 식을 평가하고, 실행 흐름을 제어할 수 있어요.

기본 기능

시맨틱 기능 말고도 Serena에는 구색을 맞추는 기본 도구가 있어요. Claude Code나 Codex 같은 에이전트 하네스 안에서 Serena를 쓰면, 하네스가 이미 겹치는 파일 · 검색 · 셸 기능을 주기 때문에 이 도구들은 보통 기본으로 꺼져 있어요.

  • search_for_pattern – 코드베이스 전체에서 유연한 정규식 검색
  • replace_content – 에이전트에 맞게 다듬은 정규식 · 문자열 그대로 바꾸기
  • list_dir / find_file – 디렉터리 나열과 파일 찾기
  • read_file – 파일이나 파일 일부 읽기
  • execute_shell_command – 셸 명령 실행(예: 빌드, 테스트, 린터)

기억 관리

기억 시스템은 오래 이어지는 에이전트 작업에 꼭 필요해요. 지식을 여러 세션 · 사용자 · 프로젝트가 함께 쓸 때 특히 그래요. 단순한데도, Serena의 기억 관리 시스템을 에이전트 자체 시스템(예: AGENTS.md 파일)과 함께 쓰는 사용자들이 좋은 반응을 보였어요. 다른 걸 쓰고 싶다면 쉽게 끌 수 있어요.

설정 가능성

켜 둘 도구, 도구 설명, 프롬프트, 언어 백엔드 세부 사항 같은 Serena의 여러 부분을 YAML 몇 줄만 고쳐서 경우에 따라 유연하게 설정할 수 있어요. 이를 위해 Serena는 여러 층의(조합할 수 있는) 설정을 제공해요.

  • 전역 설정
  • MCP 실행 명령(CLI) 설정
  • 프로젝트별 설정(로컬 덮어쓰기 포함)
  • 실행 맥락별 설정(예: 특정 클라이언트용)
  • 동적으로 조합할 수 있는 설정 조각(모드)

빠른 시작

⚠️ 중요 MCP나 플러그인 마켓플레이스로 Serena를 설치하지 마세요! 그 안에는 오래됐거나 최적이 아닌 설치 명령이 들어 있어요.

준비물. Serena는 uv로 관리돼요. uv를 설치하는 것이 유일하게 꼭 필요한 준비예요.

Serena 설치. Serena는 uv로 이렇게 설치해요.

uv tool install -p 3.13 serena-agent

설치가 끝나면 셸에서 serena 명령을 쓸 수 있어야 해요.

📝 참고 언어 서버 백엔드를 쓸 때는 일부 언어를 지원하려고 추가 의존성을 설치해야 할 수 있어요. 자세한 내용은 언어 지원 페이지를 보세요.

Serena 초기화. Serena를 초기화하고 설정이 제대로 됐는지 확인하려면 이렇게 실행하세요.

serena init

기본으로는 언어 서버 백엔드를 쓰도록 설정돼요. 대신 JetBrains 백엔드를 쓰려면 -b JetBrains를 붙이세요(추가 사용법은 JetBrains 플러그인 문서 페이지를 보세요). 어느 쪽이든 Serena가 성공적으로 초기화됐다는 메시지가 나와야 해요.

클라이언트 설정. Serena를 쓰는 MCP 클라이언트에 연결하려면 보통 클라이언트에 실행 명령을 설정해야 해요. 링크를 따라가면 Claude Code, Codex, Claude Desktop, MCP를 지원하는 IDE, 그 밖의 클라이언트(로컬 · 웹 기반 GUI 등)에 Serena를 설정하는 방법이 나와요.

💡 팁 빠르게 시작하기는 쉽지만 Serena는 설정 옵션이 많은 강력한 도구 모음이에요. Serena를 최대한 활용하려면 사용자 가이드를 꼭 읽어 보라고 권해요.

특히 아래 두 가지를 읽어 보세요.

사용자 가이드

Serena를 효과적으로 쓰는 자세한 방법은 사용자 가이드를 보세요.

감사의 말

Serena의 상당 부분, 특히 여러 언어 지원은 오픈소스 커뮤니티가 만들어 주었어요. 이를 가능하게 하고, 오늘의 Serena가 되는 데 중요한 역할을 한 많은 기여자께 깊이 감사해요.

라이선스

Serena는 구성요소별로 라이선스가 달라요. SolidLSP(src/solidlsp)는 MIT 라이선스, Serena 애플리케이션(그 밖의 모든 것)은 GPL-3.0-or-later예요. 둘을 합쳐 배포하는 경우 전체는 GPL을 따라요.

공식 개요는 LICENSE를, 배경은 라이선스 문서를 보세요. 기여하려면 CLA에 동의해야 해요. CONTRIBUTING.md를 보세요.

mcp-name: io.github.oraios/serena