클로드 개발 서버

Claude가 지정된 작업 공간 내에서 직접 파일 시스템에 액세스할 수 있도록 하여 소프트웨어 개발을 지원할 수 있는 MCP(Model Context Protocol) 서버입니다.

특징

• 🔍 파일 내용 읽기
• ✍️ 파일 작성 및 수정
• 📁 디렉토리 생성
• 📋 파일 및 디렉토리 나열
• ℹ️ 파일 정보 가져오기
• 🛠️ Claude에서 직접 코드 아티팩트를 구현합니다.

설치

1. Python 3.10 이상이 설치되어 있는지 확인하세요.
2. 새 프로젝트 디렉토리를 만듭니다.

지엑스피1

3. UV를 사용하여 가상 환경을 설정합니다.

4. 편집 가능한 모드로 패키지를 설치하세요:

프로젝트 구조

구성

Claude Desktop과 함께 서버를 사용하려면 Claude Desktop 구성 파일에 서버를 추가하세요.

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

다음 구성을 추가합니다.

바꾸다:

• mcp-claude-dev 디렉토리에 대한 절대 경로를 포함하는 PATH_TO_YOUR_PROJECT
• Claude가 파일 액세스 권한을 가져야 하는 디렉토리의 절대 경로를 포함하는 PATH_TO_YOUR_WORKSPACE

용법

1. Claude Desktop 시작
2. 도구 메뉴(망치 아이콘)에 서버가 나타납니다.
3. 이제 Claude에게 다음을 요청할 수 있습니다.
   • 파일 읽기: "file.txt의 내용을 읽을 수 있나요?"
   • 파일 쓰기: "기본 Flask 앱으로 example.py라는 새 파일을 만듭니다."
   • 디렉토리 나열: "현재 디렉토리에 어떤 파일이 있나요?"
   • 디렉토리 생성: "src"라는 이름의 새 디렉토리를 생성합니다.
   • 파일 정보 가져오기: "main.py의 크기와 수정 날짜는 무엇입니까?"
   • 코드 구현: "피보나치 수를 계산하는 Python 함수를 작성하여 math_utils.py에 저장하세요"

보안 참고 사항

• 서버는 지정된 작업 공간 디렉토리 내의 파일에만 액세스를 허용합니다.
• 모든 파일 작업에는 작업 공간에 대한 명시적 경로가 필요합니다.
• 작업 공간 외부의 디렉토리 탐색 시도는 차단됩니다.
• 변경 감지를 위해 파일 감시가 구현되었습니다.

개발

프로젝트에 기여하려면:

1. 저장소를 복제합니다
2. 개발 종속성 설치
3. 변경 사항을 만드세요
4. 풀 리퀘스트를 제출하기 전에 철저히 테스트하세요

테스트 실행

사용 가능한 도구

서버는 다음 MCP 도구를 제공합니다.

• read_file(path: str) -> str : 파일 내용을 읽습니다.
• write_file(path: str, content: str) -> str : 파일에 내용을 씁니다.
• list_files(path: str = "") -> str : 디렉토리 내용 나열
• create_directory(path: str) -> str : 새로운 디렉토리를 생성합니다.
• get_file_info(path: str) -> str : 파일 메타데이터 가져오기
• implement_artifact(path: str, content: str) -> str : 코드 아티팩트 저장

오류 처리

서버에는 다음에 대한 강력한 오류 처리 기능이 포함되어 있습니다.

• 잘못된 경로
• 작업 공간 외부에서 액세스 시도
• 파일 작업 실패
• 권한 문제

특허

MIT 라이센스 - 필요에 따라 자유롭게 사용하고 수정하세요.

기여하다

기여를 환영합니다! 기여 지침을 읽고 개선 사항이 있으면 풀 리퀘스트를 제출해 주세요.