Aider MCP 서버

Claude와 다른 MCP 클라이언트가 Aider 에 연결하여 효율적인 파일 편집 기능을 제공할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 Claude와 같은 AI 비서와 Aider의 강력한 파일 편집 기능 간의 간극을 메웁니다. 모델 컨텍스트 프로토콜을 통해 표준화된 인터페이스를 제공하여 Claude가 다음과 같은 작업을 수행할 수 있도록 합니다.

• Aider의 기능을 사용하여 기존 파일 편집
• 콘텐츠로 새 파일을 만듭니다
• 마크다운 텍스트에서 코드 블록 추출
• git 상태 정보 가져오기
• Aider 설치 상태 확인
• Aider의 구성 시스템에 접속하여 사용하세요

필수 조건

• Python 3.8 이상
• Aider 설치( pip install aider-chat )
• OpenAI 또는 Anthropic용 API 키(Aider에서 사용할 모델에 따라 다름)
• 파일 편집을 위한 Git 저장소

설치

Aider MCP 서버는 여러 가지 방법으로 설치할 수 있습니다.

UV 사용(권장)

uv가 설치되어 있는 경우:

지엑스피1

PIP 사용

용법

Aider MCP 서버는 기본적으로 stdio를 통한 MCP 프로토콜 모드로 실행되며, Claude Desktop 및 Cursor IDE와 같은 MCP 클라이언트와 직접 통합되도록 설계되었습니다.

명령줄 옵션

다음 환경 변수나 명령줄 인수를 사용하여 서버를 사용자 정의할 수 있습니다.

• --aider-path : Aider 실행 파일 경로(기본값: "aider", 자동으로 PATH 검색)
• --repo-path : git 저장소 경로(기본값: 현재 디렉토리)
• --config-file : 사용자 정의 Aider 구성 파일의 경로
• --env-file : 사용자 정의 .env 파일의 경로
• --verbose , -v : 자세한 출력을 활성화합니다.

클라이언트 구성

클로드 데스크탑

Claude Desktop 구성 파일에 다음을 추가하세요.

커서 IDE

Cursor IDE와 통합하려면:

1. 커서 설정 열기
2. Features > MCP Servers 로 이동
3. Add new MCP server 클릭하세요.
4. 다음 구성을 입력하세요:
   name: aider-mcp type: command command: uvx aider-mcp --repo-path=/path/to/your/repo
5. 구성 후 MCP 도구를 사용하려면 Composer에서 에이전트 모드에 있는지 확인하세요.

Aider 구성 지원

이 MCP 서버는 Aider의 구성 시스템을 지원하여 다음을 수행할 수 있습니다.

1. 다음에서 .aider.conf.yml 파일의 구성을 사용하세요.
   • 홈 디렉토리
   • git 저장소 루트
   • 현재 디렉토리
   • --config-file 로 지정된 사용자 정의 경로
2. 다음에서 .env 파일의 환경 변수를 사용합니다.
   • 홈 디렉토리
   • git 저장소 루트
   • 현재 디렉토리
   • --env-file 로 지정된 사용자 정의 경로
3. MCP 도구를 통해 파일을 편집할 때 사용자 정의 Aider 옵션을 전달합니다.

클로드에 대한 예시 프롬프트

Claude에 연결되면 다음과 같은 프롬프트를 사용할 수 있습니다.

• "main 함수에 오류 처리를 추가하기 위해 app.py 파일을 편집하세요"
• "날짜 형식 지정을 위한 도우미 함수가 포함된 utils.py라는 새 파일을 만듭니다."
• "저장소의 현재 git 상태를 보여주세요"
• "이 설명에서 Python 코드를 추출하여 파일에 저장하세요"

사용 가능한 도구

MCP 서버는 다음과 같은 디렉토리 기반 도구를 제공합니다.

• edit_files : 지정된 디렉토리에서 타겟 코드 변경을 수행합니다.
  • 디렉토리 경로와 자세한 지침이 필요합니다.
  • 제안된 모든 변경 사항을 자동으로 수락합니다( --yes-always 사용)
  • 필요한 경우 추가 Aider 옵션을 지정할 수 있습니다.
• create_files : 지정된 디렉토리에 내용이 있는 새 파일을 만듭니다.
  • 여러 개의 파일을 제공하여 한 번에 생성할 수 있습니다.
  • 선택적으로 새 파일을 git에 커밋합니다.
• git_status : 지정된 디렉토리의 저장소의 git 상태를 가져옵니다.
  • 수정, 추가, 삭제 및 추적되지 않은 파일을 확인하는 빠른 방법
• extract_code : 마크다운이나 텍스트에서 코드 블록을 추출합니다.
  • 선택적으로 추출된 코드 블록을 지정된 디렉토리의 파일에 저장할 수 있습니다.
  • 코드 블록 마커에서 언어 정보를 보존합니다.
• aider_status : Aider 설치 및 환경 상태 확인
  • Aider가 올바르게 설치되고 접근 가능한지 확인합니다.
  • 구성을 위해 특정 디렉토리를 확인할 수 있습니다.
  • API 키 및 환경 변수에 대한 보고서
• aider_config : 자세한 Aider 구성 정보 가져오기
  • 어떤 구성 파일이 사용되고 있는지 보여줍니다.
  • 모든 구성 계층의 설정을 표시합니다.
  • 사용 가능한 환경 변수를 보고합니다.

환경 변수

서버는 .env 파일을 통해 또는 직접 설정할 수 있는 환경 변수를 사용합니다.

• AIDER_PATH : Aider 실행 파일의 경로
• REPO_PATH : git 저장소 경로
• AIDER_CONFIG_FILE : 사용자 정의 Aider 구성 파일의 경로
• AIDER_ENV_FILE : 사용자 정의 .env 파일 경로
• AIDER_MCP_VERBOSE : 자세한 로깅을 활성화합니다.
• OPENAI_API_KEY : OpenAI API 키(Aider와 함께 GPT-4를 사용하는 경우)
• ANTHROPIC_API_KEY : Anthropic API 키(Aider와 함께 Claude를 사용하는 경우)

디버깅

MCP 검사기를 사용하여 서버를 디버깅할 수 있습니다.

검사기는 다음을 위한 대화형 UI를 제공합니다.

1. 사용 가능한 도구와 해당 스키마 보기
2. 테스트 매개변수를 사용하여 도구 호출
3. 응답을 확인하고 문제를 해결하세요

개발

지역 개발을 위해:

특허

무면허