MCP 프로토콜로 로컬 AI 컨텍스트 서버 설정하기
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
DevOps
대상자
VS Code와 Copilot을 사용하는 개발자, AI 기반 도구를 활용한 개발 환경 구축을 원하는 프로그래머
핵심 요약
- MCP(Model Context Protocol)는 AI 모델이 로컬 환경을 이해하도록 돕는 오픈 프로토콜
- Node.js와 NPX를 통해 로컬 MCP 서버를 구동하고 VS Code의 Copilot과 연동
settings.json
파일에 디렉터리 경로를 설정하여 Copilot이 파일 정보를 인식
섹션별 세부 요약
1. MCP 서버 설정 전 요구사항
- Node.js와 NPX 설치 확인:
node --version
,npx --version
명령어로 확인 - NPX는 npm과 함께 제공되며, 별도 설치 없이 사용 가능
2. MCP 서버 실행 방법
- npx를 통해 GitHub에서 MCP 파일 시스템 서버를 바로 실행
npx
명령어로 서버를 구동하는 방식은 전체 설치 없이 빠르게 시작 가능
3. VS Code 설정 및 Copilot 연동
- VS Code에서 "Copilot agent mode" 활성화:
File > Preferences > Settings
에서 설정 - Command Palette를 통해
settings.json
파일 열기 및 수정 settings.json
에 디렉터리 경로를 입력:"copilot.mcpServerPath": "/home/my-user/Desktop"
4. MCP 서버 선택 및 테스트
- Copilot 채팅 패널에서 "MCP server: filesystem" 옵션 선택
- 테스트 질문 예시:
"What files do I have on my desktop?"
- MCP 파일 시스템 서버가 해당 디렉터리의 파일 목록을 제공
결론
- MCP 서버 설정 후
settings.json
에 정확한 경로를 입력하여 Copilot의 로컬 파일 인식 기능 활성화 - VS Code의 Copilot 채팅 패널에서 MCP 서버 상태 확인 및 테스트 수행하여 AI 기반 개발 경험 향상 가능