Blog

Serena MCP 서버 사용법

Ashley Goolam

Ashley Goolam

8 August 2025

Serena MCP 서버 사용법

안녕하세요! AI 코딩 도구에 돈을 쏟아붓는 것에 지치셨나요? **Serena MCP 서버**에 대해 이야기해 봅시다. 이 무료 오픈소스 보석은 여러분이 가장 좋아하는 LLM을 코딩 강자로 바꿔주며, 비용을 한 푼도 들이지 않습니다. Oraios AI가 구축한 Serena는 Claude 또는 오픈 웨이트 모델과 같은 도구를 사용하여 더 스마트하게 코딩할 수 있게 해주며, 가장 좋은 점은 무료로 사용할 수 있다는 것입니다! 이 가이드에서는 Serena가 무엇인지, Claude Code 프로젝트에 설치하는 방법, 그리고 Claude Desktop 및 Cursor에 **Serena MCP 서버**를 설정하는 방법을 다룰 것입니다. 구독료를 절약해 봅시다!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스팅 도구를 원하시나요?

개발팀이 최대 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하시나요?

Apidog는 여러분의 모든 요구 사항을 충족하며, 훨씬 더 저렴한 가격으로 Postman을 대체합니다!
button

Serena MCP 서버란 무엇인가요?

**Serena MCP 서버**는 Oraios AI의 무료 오픈소스 툴킷으로, 모든 대규모 언어 모델(LLM)을 완전한 코딩 에이전트로 변환합니다. 이는 모델 컨텍스트 프로토콜(MCP)과 언어 서버 프로토콜(LSP)을 사용하여 의미론적 코드 분석, 심볼 수준 편집, 다국어 지원(Python, JavaScript, Java 등)과 같은 IDE와 유사한 기능을 제공합니다. 코드를 리팩토링하거나, 대규모 코드베이스를 분석하거나, 프로토타이핑할 때 Serena는 계획부터 버전 제어에 변경 사항을 커밋하는 것까지 모든 것을 처리합니다.

왜 훌륭할까요? Serena는 Cursor 또는 Windsurf와 같은 고가의 IDE 구독료와 Claude Code 또는 Cline과 같은 API 중심 도구에 대한 불만으로 탄생했습니다. Oraios AI는 Anthropic의 Claude(무료 티어에서도!) 또는 Agno를 통한 오픈 웨이트 모델과 같이 이미 가지고 있는 LLM과 함께 작동하는 무료 대안을 원했습니다. 이는 개발자 커뮤니티에 대한 그들의 선물이며, 그들 자신도 매일 사용합니다. 또한 MIT 라이선스이므로 원하는 대로 사용자 정의할 수 있습니다.

serena mcp server

Claude Code 프로젝트에 Serena 설치하기

무료로 MCP 서버를 지원하는 인기 있는 코딩 보조 도구인 **Claude Code**를 사용하여 프로젝트에서 **Serena MCP 서버**를 실행해 봅시다. 설정 방법은 다음과 같습니다.

1단계: 필수 구성 요소 설치

  1. **uv 설치**:
curl -LsSf https://astral.sh/uv/install.sh | sh

# 윈도우 사용자용:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

또는 Homebrew를 사용하세요: `brew install uv`.

install uv

2. **Serena 저장소 클론**:

git clone https://github.com/oraios/serena
cd serena
serena github project

3. **환경 설정**:

cp .env.example .env

2단계: Claude Code용 Serena 구성

  1. **MCP 서버 시작**:
uv run serena start-mcp-server

이것은 로그 및 종료를 위한 웹 대시보드( `http://localhost:24282/dashboard/index.html`)와 함께 로컬 서버를 시작합니다.

2. **Claude Code에 Serena 추가**:

claude mcp add-json "serena" '{"command":"uvx","args":["--from","git+https://github.com/oraios/serena","serena-mcp-server"]}'

이것은 Claude Code에 로컬 설치 없이 Serena의 MCP 서버를 사용하도록 지시합니다.

cluade code

3. **테스트하기**:

./src에 있는 내 Python 코드베이스를 분석해 줘.
main.py를 async/await를 사용하도록 리팩토링해 줘.

문제 해결

Claude Desktop에서 Serena MCP 서버 사용하기

**Claude Desktop**은 Claude의 무료 티어를 활용하여 **Serena MCP 서버**를 무료로 사용할 수 있는 또 다른 좋은 방법입니다. 연결 방법은 다음과 같습니다:

claude desktop

1단계: MCP 서버 구성

  1. **Serena의 MCP 서버 실행**:
uv run serena start-mcp-server

또는 더 깔끔한 설정을 위해 Docker (실험적)를 사용하세요:

docker run --rm -i --network host -v /path/to/your/projects:/workspaces/projects ghcr.io/oraios/serena:latest serena start-mcp-server --transport stdio

` /path/to/your/projects`를 프로젝트의 절대 경로로 바꾸세요.

2. **Claude Desktop 구성 편집**:

{
  "mcpServers": {
    "serena": {
      "command": "/path/to/uv",
      "args": ["run", "--directory", "/path/to/serena", "serena-mcp-server"]
    }
  }
}

` /path/to/uv`와 ` /path/to/serena`를 실제 경로로 바꾸세요 (Windows에서는 이중 백슬래시 ` \\`를 사용하세요).

add new mcp server to claude desktop

3. **Claude Desktop 다시 시작**:

2단계: Claude Desktop에서 Serena 테스트

  1. **대화 시작**:
내 프로젝트를 ./myproject에서 요약해 줘.

2. **코딩 작업 시도**:

로그를 기반으로 src/app.js의 버그를 수정해 줘.

3. **대시보드 확인**:

팁

Cursor에서 Serena MCP 서버 사용하기

**Cursor**는 세련된 AI 기반 IDE이며, Cursor에서 **Serena MCP 서버**를 전역적으로 또는 프로젝트별로 사용할 수 있습니다. 방법은 다음과 같습니다:

the cursor ide

1단계: Serena의 MCP 서버 설정

  1. **서버 시작**:
uv run serena start-mcp-server

또는 Claude Desktop 섹션의 Docker 명령을 사용하세요.

2. **Cursor 전역적으로 구성**:

{
  "mcpServers": {
    "serena": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/oraios/serena", "serena-mcp-server"]
    }
  }
}

이렇게 하면 Serena가 모든 Cursor 프로젝트에서 사용할 수 있게 됩니다.

add new mcp server to cursor

3. **또는 프로젝트별로 구성**:

4. **Cursor 다시 시작**:

2단계: Cursor에서 Serena 테스트

  1. **Cursor의 채팅 패널 열기**:
src/api.py에 REST API를 생성해 줘.

2. **코드 리팩토링**:

이 함수의 성능을 최적화해 줘.

3. **로그 확인**:

Serena MCP 서버를 사용해야 하는 이유

**Serena MCP 서버**는 구독 비용에 지친 개발자들에게 구세주입니다. 다음과 같은 이유로 훌륭합니다:

사용자들은 Serena에 대해 열광하고 있으며, 일부는 Claude와 함께 사용하면 "가장 강력한 코딩 설정"이라고 부릅니다. 솔로 개발자이든 팀에 속해 있든, Serena는 값비싼 구독을 취소하고 더 스마트하게 코딩할 수 있게 해줍니다. 곧 ChatGPT Desktop이 MCP 서버를 지원하여 옵션을 더욱 확장할 수도 있습니다.

결론

**Serena MCP 서버**는 Claude Code, Claude Desktop, Cursor와 같은 도구를 사용하여 무료로 AI 기반 코딩을 할 수 있는 티켓입니다. Serena를 설치하는 것부터 좋아하는 편집기에서 실행하는 것까지, 이제 구독료 문제 없이 코딩 작업을 해결할 수 있습니다. 한번 사용해보고 웹 대시보드를 탐색해 보세요. 그리고 Serena를 사용하여 워크플로우를 어떻게 향상시키고 있는지 댓글로 알려주세요!

💡
아름다운 API 문서를 생성하는 훌륭한 API 테스팅 도구를 원하시나요?

개발팀이 최대 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하시나요?

Apidog는 여러분의 모든 요구 사항을 충족하며, 훨씬 더 저렴한 가격으로 Postman을 대체합니다!
button

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드