본문으로 건너뛰기
CoderRed Blog

Article

Serena MCP로 Claude Code 토큰 70% 절약하기 - 무료 성능 업그레이드의 비밀

게시 읽기5분 분량958자 작성CoderRed Serena MCPClaude CodeMCP토큰 절약LSP무료 코딩 도구AI 코딩Language Server Protocol+4Serena MCPClaude CodeMCP토큰 절약+8
목차

Claude Code 쓰다가 토큰 한계 때문에 작업을 중단한 경험 있으신가요? 저도 그랬습니다. 그런데 Serena MCP를 알게 된 순간, 모든 게 바뀌었어요.

😤 문제의 시작 - Claude Code의 토큰 폭탄

Claude Code는 정말 강력한 도구입니다. 터미널에서 코딩을 도와주는 AI 어시스턴트로, 처음 써봤을 때 “이거 진짜 편하네!” 했죠.

그런데 문제가 있었습니다.

파일 하나 읽는데 토큰을 엄청나게 먹어치우더라고요. “이 함수 어디 있지?” 물어보면 전체 프로젝트를 다 뒤지면서 토큰을 소비합니다. 심지어 필요 없는 파일까지 읽어요.

결과는? 한 시간도 안 돼서 일일 한계 도달. 😅

월 $100 유료 플랜을 쓰더라도, 큰 프로젝트에선 금방 한계에 부딪힙니다. 이게 바로 현재 AI 코딩 도구들의 고질적인 문제죠.

🌟 구원자의 등장 - Serena MCP

그러던 중 발견한 게 Serena MCP입니다.

검색 결과를 보니 “토큰을 최대 70%까지 절약한다"는 후기가 있더라고요. 반신반의하며 써봤는데…

진짜였습니다! 🎉

커뮤니티 피드백에 따르면 실제로 많은 개발자들이 60-70%의 토큰 절감 효과를 체감하고 있었어요. 어떻게 이게 가능할까요?

🔍 Serena MCP가 특별한 이유

심볼 레벨 코드 이해 - LSP의 마법

일반적인 MCP 서버들은 코드를 단순 텍스트로 취급합니다. 검색할 때 grep처럼 문자열을 찾죠.

하지만 Serena는 다릅니다. **Language Server Protocol (LSP)**을 활용해서 코드를 의미 있는 구조로 이해합니다.

문서에 따르면:

  • 함수, 클래스, 변수를 심볼로 인식
  • 참조 관계를 정확히 파악
  • IDE처럼 똑똑하게 코드 탐색

즉, “이 함수 찾아줘"라고 하면:

  • ❌ 일반 MCP: 전체 프로젝트 파일을 다 읽음 → 토큰 폭탄
  • ✅ Serena: LSP로 심볼만 정확히 찾음 → 토큰 절약

무료로 쓸 수 있다는 점

공식 문서에서 강조하는 포인트가 있어요:

“Cursor나 Windsurf 같은 유료 IDE 구독료를 내기 싫어서 만들었다”

Oraios AI 팀이 직접 쓰기 위해 만든 도구라, 무료 오픈소스로 공개했습니다. Claude 무료 티어에서도 완벽하게 작동하죠!

지원 언어

문서를 확인해보니 정말 광범위합니다:

  • Python (pylsp)
  • JavaScript/TypeScript (typescript-language-server)
  • Rust (rust-analyzer)
  • Go (gopls)
  • Java, C/C++, PHP, Ruby 등

12개 이상의 언어를 바로 지원하고, 언어 서버를 자동으로 설치해줍니다!

🛠️ 설치 방법

설치는 정말 간단합니다. 한 줄이면 끝나요.

1. uv 설치 (필수)

Serena는 uv라는 Python 패키지 관리자를 사용합니다.

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Homebrew
brew install uv

2. Claude Code에 추가

프로젝트 폴더에서 이 명령어 하나만 실행하세요:

claude mcp add serena -- uvx --from git+https://github.com/oraios/serena \
  serena start-mcp-server --context ide-assistant --project $(pwd)

끝! 이제 Claude Code를 실행하면 Serena가 자동으로 연결됩니다.

Windows 사용자 주의: WSL 환경에서 uvx 오류가 발생할 수 있습니다. 이 글을 참고하세요!

3. 연결 확인

claude

Claude Code 실행 후:

/mcp

이렇게 입력하면 연결된 MCP 서버 목록이 나옵니다. serena: connected 가 보이면 성공!

🎯 첫 사용 - Onboarding

Serena를 처음 쓸 때는 Onboarding 과정이 필요합니다.

Claude에게 이렇게 요청하세요:

Serena onboarding을 시작해줘

Onboarding은 프로젝트를 분석해서 이해하는 과정입니다:

  • 프로젝트 구조 파악
  • 주요 심볼 인덱싱
  • 메모리 생성 (.serena/memories/ 폴더)

주의: 첫 Onboarding은 토큰을 좀 많이 씁니다! 하지만 이후로는 엄청난 토큰 절약 효과가 있으니 투자할 가치가 충분해요.

💡 실전 활용 팁

심볼 검색의 위력

일반 검색 대신 이렇게 요청해보세요:

사용자 인증 처리하는 함수들 찾아줘

Serena는 LSP를 통해:

  1. 관련 함수 심볼을 정확히 찾음
  2. 필요한 코드만 가져옴
  3. 참조 관계도 파악

결과: 전체 파일 읽는 대신 필요한 심볼만 가져와서 토큰 대폭 절약!

리팩토링 작업

AuthService 클래스의 login 메서드를 개선해줘

Serena는:

  • 해당 메서드만 정확히 찾음
  • 심볼 단위로 수정
  • 참조하는 곳도 자동으로 찾아서 알려줌

공식 문서에서도 강조하는데, 심볼 레벨 편집이 가능해서 라인 단위 수정보다 훨씬 정확합니다.

메모리 시스템 활용

긴 작업을 할 때는 메모리를 활용하세요:

현재 작업 상황을 메모리에 저장해줘

그러면 .serena/memories/ 폴더에 마크다운 파일로 저장됩니다. 나중에 새 대화에서:

저번에 저장한 메모리 읽고 작업 계속해줘

이렇게 하면 컨텍스트를 잃지 않고 작업을 이어갈 수 있어요!

웹 대시보드

Serena를 실행하면 자동으로 웹 대시보드가 열립니다:

http://localhost:24282/dashboard/index.html

여기서 할 수 있는 것:

  • 실시간 로그 확인
  • 사용한 도구 모니터링
  • 안전한 서버 종료

많은 MCP 클라이언트가 프로세스를 제대로 정리하지 못해 좀비 프로세스를 남기는데, 대시보드에서 깔끔하게 종료할 수 있습니다.

🚀 실제 효과

커뮤니티 피드백을 종합해보면:

토큰 절약

  • 일반 작업: 60-70% 절감
  • 대규모 프로젝트: 더욱 효과적

속도 개선

  • LSP 기반 검색이 빠름
  • 불필요한 파일 읽기 제거

코드 품질

  • 심볼 레벨 이해로 정확한 수정
  • 참조 관계 파악으로 부작용 감소

한 개발자의 후기를 보면:

“60-70% 토큰 절감! Claude Code 한계에 부딪히는 시간이 확실히 늘어났어요”

⚙️ 다른 MCP와의 차이점

공식 문서에서 명확히 밝히고 있습니다:

기존 MCP 서버들 (DesktopCommander, codemcp 등)

  • 텍스트 기반 분석만 가능
  • grep 스타일 검색
  • 파일 전체를 읽어야 함

Serena MCP

  • LSP 기반 의미론적 분석
  • 심볼 레벨 검색
  • 필요한 부분만 정확히 가져옴

이 차이가 토큰 효율의 핵심입니다!

🔧 프로젝트별 vs 전역 설정

상황에 따라 선택하세요:

프로젝트별 설정 (위에서 한 방법)

  • 해당 폴더에서만 Serena 활성화
  • 프로젝트마다 다른 설정 가능

전역 설정

claude mcp add serena -- uvx --from git+https://github.com/oraios/serena \
  serena start-mcp-server --context ide-assistant
  • 모든 프로젝트에서 사용 가능
  • 한 번만 설정하면 끝

💰 비용 관점에서

Claude Code (월 $100)

  • API 사용량에 따라 과금
  • 토큰 많이 쓰면 금방 한계

Claude Code + Serena MCP

  • 토큰 70% 절감 = 2.5~3배 더 작업 가능
  • 무료 티어로도 충분히 활용 가능

Cursor나 Windsurf 구독료(월 $20-40)를 내는 대신, Serena로 Claude 무료 티어를 효율적으로 쓰는 게 훨씬 경제적입니다!

⚠️ 주의사항

Onboarding 토큰

처음 프로젝트 분석할 때는 토큰을 많이 씁니다. 하지만 한 번만 하면 되고, 이후 절약 효과가 크니 걱정 마세요.

.serena 폴더 관리

.gitignore에 추가하세요:

.serena/

프로젝트 메모리와 캐시가 저장되는 폴더라 Git에 올릴 필요 없습니다.

Windows 이슈

WSL에서 uvx 오류가 날 수 있어요. 트러블슈팅 가이드를 확인하세요.

🎓 추천 워크플로우

검색 결과에서 본 베스트 프랙티스입니다:

  1. 프로젝트 시작

    • Serena 설치 및 Onboarding
    • .serena 폴더를 .gitignore에 추가

  2. 기능 개발

    • 심볼 검색으로 관련 코드 찾기
    • 심볼 단위 수정으로 정확한 편집
    • 참조 확인으로 부작용 방지

  3. 긴 작업시

    • 작업 상황을 메모리에 저장
    • 새 대화에서 메모리 읽고 계속

  4. 모니터링

    • 웹 대시보드에서 로그 확인
    • 필요시 안전하게 종료

🌈 마무리

Serena MCP는 Claude Code를 쓰는 모든 개발자에게 필수 도구입니다.

핵심 장점 정리:

  • ✅ 토큰 60-70% 절약 (실사용자 증언)
  • ✅ LSP 기반 심볼 레벨 코드 이해
  • ✅ 12개 이상 언어 지원
  • ✅ 완전 무료 오픈소스
  • ✅ Claude 무료 티어에서도 강력함

설치는 한 줄, 효과는 엄청납니다. 아직 안 써보셨다면 지금 바로 시도해보세요!

다음 편에서는 다른 필수 MCP 서버들을 소개하겠습니다. GitHub, Linear, Sentry 등 실무에서 바로 쓸 수 있는 도구들이 기다리고 있어요! 😊

궁금한 점이나 경험담이 있으시면 댓글로 공유해주세요! 함께 성장해나가요! 💪

댓글