로컬 MCP 4개 설치 가이드

추석 AI 부트캠프 하루 6시간 만에
AI 기초부터 나만의
서비스까지 완성 이번 연휴를 기회로 삼으세요일정 보기 ↗

Quick Start

MCP는 AI 앱과 도구 사이의 연결 규격입니다. 서버를 실행하는 명령과 접근할 폴더를 등록하면 클라이언트가 해당 도구를 호출합니다. 파일·Git 기능은 클로드 코드의 기본 도구로도 사용할 수 있습니다. 여기서는 네 서버를 연결하고 응답을 확인하는 순서로 익힙니다.

1. STEP 1에서 빈 연습 폴더와 필요한 실행 도구를 준비합니다.
2. STEP 2~4에서 파일·Git·메모리 서버를 프로젝트에 등록합니다.
3. STEP 5에서 시각 변환을 확인하고 필요한 도구부터 사용합니다.

STEP 1 · 1분빈 프로젝트를 만든다

Node.js와 uv, Claude Code가 설치된 터미널에서 시작합니다. Node.js는 npx 서버를, uv는 Python 서버를 실행합니다. 실습용 파일만 둔 폴더를 사용하고 터미널의 현재 위치를 확인합니다.

mkdir mcp-practice
cd mcp-practice
mkdir demo
git -C demo init
printf 'Project: Demo Cafe\nDecision: Keep the menu page simple.\n' > demo/brief.txt

성공하면 demo 안에 brief.txt와 빈 Git 저장소가 생깁니다. 이 단계에서는 커밋을 만들지 않습니다. 이어지는 명령의 --scope project는 현재 프로젝트의 .mcp.json에 서버를 기록합니다.

STEP 2 · 1분Filesystem으로 메모를 읽고 저장한다

Filesystem에는 접근을 허용할 폴더를 인자로 전달합니다. 아래 설정은 demo만 지정합니다. 사용자의 홈 폴더 전체를 넣을 필요가 없습니다.

claude mcp add --scope project files -- npx -y @modelcontextprotocol/server-filesystem "$PWD/demo"

성공하면 Added stdio MCP server files와 프로젝트 설정 파일 경로가 표시됩니다. 클로드 코드에서 /mcp로 서버 상태를 확인한 뒤 files 서버로 demo/brief.txt를 읽고 내용을 result.txt로 저장하도록 지시합니다. 실제 도구 호출에서는 read_text_file로 메모를 읽고 write_file로 새 파일을 저장한 뒤 다시 읽었습니다.

STEP 3 · 1분Git으로 새 파일을 확인한다

Git 서버에는 연습 저장소 위치를 전달합니다. git_status는 현재 브랜치와 새 파일 상태를 확인하는 도구입니다.

claude mcp add --scope project git -- uvx mcp-server-git --repository "$PWD/demo"

성공하면 git 서버가 프로젝트 설정에 추가됩니다. 실제 git_status 응답에는 No commits yet와 Untracked files, brief.txt·result.txt가 나왔습니다. 파일 목록은 앞서 만든 파일에 따라 달라집니다. 상태 조회만으로 파일을 저장하거나 커밋하지는 않습니다.

STEP 4 · 1분Memory에 프로젝트 결정을 저장한다

Memory는 이름·종류·관찰 내용을 지식 그래프로 저장합니다. 저장 파일도 연습 폴더 안으로 지정하면 이 프로젝트의 데이터 위치를 알 수 있습니다.

claude mcp add --scope project memory --env MEMORY_FILE_PATH="$PWD/demo/memory.jsonl" -- npx -y @modelcontextprotocol/server-memory

성공하면 memory 서버가 등록됩니다. Demo Cafe라는 프로젝트에 Keep the menu page simple.이라는 결정을 저장하고 이름으로 검색합니다. 실제 create_entities 후 서버 프로세스를 종료하고 다시 시작해 search_nodes를 호출했을 때 같은 결정이 응답에 남아 있었습니다.

STEP 5 · 1분Time으로 도시 사이 시각을 바꾼다

Time은 시간대 이름을 받아 현재 시각 조회와 변환을 수행합니다. 도시의 이름 대신 Asia/Seoul, Europe/London처럼 시간대 식별자를 사용합니다.

claude mcp add --scope project time -- uvx mcp-server-time

성공하면 time 서버가 등록됩니다. 서울 18:00을 런던 시각으로 변환하도록 지시합니다. convert_time 도구는 원본·대상 시간대와 날짜, 서머타임 여부, 시차를 반환합니다. 설치 후에는 /mcp에서 필요한 서버의 연결 상태를 확인합니다.

자주 막히는 곳

npx 또는 uvx를 찾지 못합니다. Node.js와 uv 설치 후 새 터미널에서 각 명령을 확인합니다. 서버 실행 경로가 다른 환경이면 실행 파일의 절대 경로를 설정합니다.

Filesystem 접근이 거절됩니다. 설정에 넣은 허용 폴더와 실제 파일 위치를 대조합니다. 다른 위치를 열기 위해 무작정 홈 폴더 전체를 허용하지 않습니다.

알아 둘 한계

• STEP의 분 표시는 읽기·실습을 나누기 위한 계획 시간이며 완료 소요 시간 측정값이 아닙니다.
• 기준일은 2026년 10월 3일입니다. 네 서버는 MCP 공식 저장소의 교육용 참조 구현이며 운영용 완성 솔루션을 보증하지 않습니다.
• 영상은 격리된 임시 프로젝트에서 Claude Code의 등록 명령과 공식 MCP SDK 클라이언트의 실제 도구 호출을 기록했습니다. Claude 모델의 자율 대화 실행이나 /mcp 화면을 검증한 영상은 아닙니다.
• 추가 서버 요금·로그인·API 키 없이 실행했지만 Claude 모델 사용에는 별도 이용 조건이 적용됩니다. Node.js·uv·각 패키지의 내려받기가 필요합니다.
• Memory는 명시적으로 저장한 내용을 검색합니다. 모든 대화가 자동으로 저장되거나 항상 기억된다는 뜻이 아닙니다. Git 서버의 다른 변경 도구도 있어 상태 조회 목적에 맞는 권한으로 사용합니다.
• 실측에서 서울 18:00은 런던 10:00, 시차는 -8시간이었습니다. 날짜·서머타임에 따라 달라지는 값이므로 고정 시차로 안내하지 않습니다.

FAQ

네 개를 모두 켜야 합니까? 아닙니다. 확인하려는 결과에 맞춰 필요한 서버만 사용합니다. 기본 파일·Git 도구로 충분한 작업에 반드시 추가할 필요는 없습니다.

일반 클로드 채팅에 명령을 붙이면 됩니까? 아닙니다. 이 가이드는 터미널의 Claude Code 프로젝트 설정을 다룹니다. 다른 앱은 각 앱의 MCP 설정 방법을 따릅니다.

공식 참고 자료

• MCP 공식 — 참조 서버의 범위
• Filesystem 공식 — 허용 폴더와 파일 도구
• Git 공식 — 저장소 상태 도구
• Memory 공식 — 지식 그래프와 저장 파일
• Time 공식 — 시간대 변환

공식 설치 안내와 도구 응답은 2026년 10월 3일에 직접 열고 실행해 확인한 내용입니다.