uv 를 통한 mcp 설치 및 mcpo 적용 - 우분투 및 윈도우즈 기반
uv를 통한 MCP 설치 및 MCPO 적용 가이드 (우분투 & 윈도우즈)
이 가이드는 uv(초고속 파이썬 패키지 관리자)를 이용해 MCP(Multi-client Protocol) 서버 및 MCPO(옵션/플러그인 등) 환경을 우분투와 윈도우 양쪽에서 설치·적용하는 절차를 설명합니다.
준비사항
- Python이 사전 설치되어 있어야 하며, 설치 시 반드시 PATH에 등록해야 합니다.
- 인터넷 연결 필요.
1. uv 설치
우분투(리눅스)에서:
curl -LsSf https://astral.sh/uv/install.sh | sh
혹은
wget -qO- https://astral.sh/uv/install.sh | sh
윈도우즈에서: PowerShell(관리자 권한 권장)에서 아래 명령 실행:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
설치 후 터미널에 아래 명령으로 정상 설치 여부 확인:
uv --version
정상적으로 버전이 출력되면 성공입니다[1][4].
2. MCP 서버 설치 및 환경 구축
1) 프로젝트 폴더 생성 및 이동
mkdir my_mcp_project
cd my_mcp_project
2) MCP 서버 설치
- 필요한 MCP 서버 패키지(예: screenpipe-mcp 등)를 uv로 설치:
uv pip install screenpipe-mcp
- 또는 공식 문서에서 안내하는 MCP 서버별 패키지명을 사용합니다.
3) MCP 서버 환경 설정
- 대부분 screenpipe 등에서는 세팅 명령을 제공합니다:
screenpipe mcp setup
- 실행 후 MCP 환경 경로와 config 파일이 생성됩니다:
MCP setup completed successfully
Directory: C:\Users\사용자\.screenpipe\mcp
Config file: C:\Users\사용자\.screenpipe\mcp\config.json
(윈도우 예시, 우분투도 유사)[4].
3. MCP 서버 실행
설정이 완료된 디렉터리에서 MCP 서버 실행:
uv --directory <MCP_설정_경로> run screenpipe-mcp --port 3030
<MCP_설정_경로>는 setup 명령에서 안내받은 경로로, 예:~/.screenpipe/mcp또는C:\Users\사용자\.screenpipe\mcp[4].- 포트는 원하는 대로 지정(기본 예시 3030).
4. MCPO(플러그인/옵션 등) 적용 방법
- 공식 MCP 문서나 커뮤니티에서 제공하는 플러그인 또는 옵션을 확인합니다.
- uv를 통해 추가 패키지 설치(예시):
uv pip install mcp-plugin-example
- config.json 등 설정 파일에서 플러그인 옵션이나 모듈을 활성화합니다.
- 서버를 다시 실행하여 적용 상태를 확인합니다[2][4].
5. 주요 참고사항 및 FAQ
- uv 사용의 이점: 의존성 설치 속도가 매우 빠르며, MCP와 같은 최신 AI 에이전트/서버 프로젝트와 호환성이 좋음.
- MCP 서버/클라이언트는 각 프로젝트별 가이드에 따라 추가 설정이 필요할 수 있음.
- 각각의 프로젝트, 예: 11랩스, Weather 등은 uv 기반 명령을 한 줄로 설치 가능하며, mcp-x 등 별도 CLI나 명령을 활용할 수도 있음[2].
요약
- uv 설치 → MCP 서버 패키지 설치 → 환경 셋업 → 서버 실행 → 플러그인(MCPO) 적용
- 우분투/윈도우 모두 명령만 다르고 전체 흐름 및 관리 방식은 동일.
- 문제 발생 시 uv 공식문서, MCP 서버별 레퍼런스 문서를 우선 참조.
이 가이드는 실제 운영 환경 및 프로젝트별로 세부 명령어가 달라질 수 있으니, MCP 및 MCPO 관련 공식 문서를 항상 확인하는 것이 좋습니다.
https://docs.astral.sh/uv/getting-started/installation/,https://www.youtube.com/watch?v=1kZ-touiEQ8,https://mcp.so/en/server/MCPTutorial/SageChisanga,https://docs.screenpi.pe/mcp-server,https://velog.io/@gogocomputer/MCP-%EC%9E%85%EB%AC%B8-%EB%AF%B8%EB%A6%AC-%EA%B5%AC%EC%B6%95%EB%90%9C-MCP-%EC%84%9C%EB%B2%84%EB%82%A0%EC%94%A8-%EC%84%9C%EB%B2%84-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0
