로컬 MCP 4개 설치 가이드
Quick Start
MCP는 AI 앱과 도구 사이의 연결 규격입니다.
서버를 실행하는 명령과 접근할 폴더를 등록하면 클라이언트가 해당 도구를 호출합니다.
파일·Git 기능은 클로드 코드의 기본 도구로도 사용할 수 있습니다.
여기서는 네 서버를 연결하고 응답을 확인하는 순서로 익힙니다.
- STEP 1에서 빈 연습 폴더와 필요한 실행 도구를 준비합니다.
- STEP 2~4에서 파일·Git·메모리 서버를 프로젝트에 등록합니다.
- 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 접근이 거절됩니다.
설정에 넣은 허용 폴더와 실제 파일 위치를 대조합니다.
다른 위치를 열기 위해 무작정 홈 폴더 전체를 허용하지 않습니다.
FAQ
네 개를 모두 켜야 합니까? 아닙니다.
확인하려는 결과에 맞춰 필요한 서버만 사용합니다.
기본 파일·Git 도구로 충분한 작업에 반드시 추가할 필요는 없습니다.
일반 클로드 채팅에 명령을 붙이면 됩니까? 아닙니다.
이 가이드는 터미널의 Claude Code 프로젝트 설정을 다룹니다.
다른 앱은 각 앱의 MCP 설정 방법을 따릅니다.
공식 참고 자료
이메일 남기고 전체 바로 보기