astral uv mcp

개요

astral uv mcp (일반적으로 uv-mcp로 알려짐)은 오픈소스 모델 컨텍스트 프로토콜(MCP) 서버로, Astral의 uv—Rust 기반의 초고속 Python 패키지 및 프로젝트 관리자—를 Claude Desktop, Claude Code, Gemini CLI와 같은 AI 에이전트 및 도구와 연결합니다.

AI 어시스턴트가 단순히 uv 명령어를 제안하는 것 대신, uv-mcp를 통해 AI가 Python 프로젝트 환경을 직접 검사, 진단 및 수정할 수 있게 하여, AI를 Python 개발을 위한 적극적인 DevOps 파트너로 만듭니다.

특징

• 환경 진단: 프로젝트 구조, 가상 환경, 의존성 충돌, 락파일(uv.lock), pyproject.toml을 자동으로 분석합니다.
• 자체 치유 수리: 가상 환경 생성, 프로젝트 초기화, 의존성 동기화, 문제 해결을 단일 도구 호출로 수행합니다. -A 의존성 관리: 자연어를 통해 패키지(개발 의존성 포함)를 추가, 제거 또는 업데이트합니다—플래그나 명령어를 기억할 필요가 없습니다.
• 네이티브 uv 통합: uv 워크플로우, PEP 668 외부 관리 환경을 완전히 준수하며 uv.lock으로 재현 가능한 설정을 보장합니다. .
• MCP 호환성: Claude, Gemini CLI 확장 및 기타 AI 에이전트 플랫폼을 포함한 MCP 클라이언트와 원활하게 작동합니다.
• 범위 지정 및 안전성: 작업은 프로젝트 범위로 제한되어 전역 오염이 없으며, 컨테이너, CI/CD 및 관리 환경에 이상적입니다. .
• 감사 가능 및 결정론적: 명확한 로그와 머신 간 일관된 동작으로 신뢰할 수 있는 자동화를 제공합니다.

사용 사례

AI 기반 Python 설정: 에이전트에게 "pandas와 Jupyter로 새로운 데이터 과학 프로젝트를 설정해 줘"라고 말하면—uv init, 가상 환경 생성, 의존성 설치를 처리합니다. .

• 환경 문제 해결: AI가 "내 프로젝트가 실행되지 않는 이유"를 진단하고 자동으로 수리합니다.

의존성 해결: 수동 개입 없이 충돌 해결 또는 락파일 업데이트.

• 다중 에이전트 워크플로우: 전체 Python 개발 자동화를 위한 더 큰 MCP/AI 에이전트 오케스트레이션에 통합.

CI/CD 및 재현 가능한 빌드: 자동화된 파이프라인에서 일관된 환경 보장.

설치 및 빠른 시작

Gemini CLI용 (권장)

gemini extensions install https://github.com/saadmanrafat/uv-mcp

Claude Desktop / Code용

저장소를 클론하고 MCP 구성에 추가하세요 (자세한 내용은 문서 참조).

설치를 위해서는 uv (Astral의 패키지 관리자)가 필요합니다. 전체 안내는 저장소에서 확인하실 수 있습니다.

왜 uv-mcp인가요?

uv는 이미 pip/Poetry와 같은 기존 도구보다 10-100배 빠릅니다. uv-mcp는 AI 에이전트에 직접적이고 안전한 접근 권한을 부여하여 그 성능을 강화합니다—"내 머신에서는 작동하는데"를 신뢰할 수 있는 에이전트 주도 재현성으로 전환합니다.

링크

• GitHub: saadmanrafat/uv-mcp
• 문서: saadman.dev/uv-mcp
• uv 공식 문서: docs.astral.sh/uv

현대 AI 네이티브 Python 생태계를 위해 구축되었습니다.