FastMCP Labs

비개발자도 따라하면서 MCP 서버 개발을 체험할 수 있는 튜토리얼 리포지토리입니다.

FastMCP를 사용하여 나만의 도구를 만들고, Claude Desktop과 연동하는 방법을 단계별로 학습할 수 있습니다.

빠른 시작

1. 의존성 설치

uv sync

2. 개발 테스트

uv run fastmcp dev main.py

브라우저에서 MCP Inspector가 열리면 도구를 직접 테스트해볼 수 있습니다.

Claude Desktop 연결

설정 파일 찾기

macOS

1. Finder 열기
2. 메뉴바 > 이동 > 폴더로 이동 (⌘+Shift+G)
3. ~/Library/Application Support/Claude 입력 후 Enter
4. claude_desktop_config.json 파일을 텍스트 편집기로 열기 (파일이 없으면 새로 생성)

Windows

1. 파일 탐색기 열기 (Win+E)
2. 주소창에 %APPDATA%\Claude 입력 후 Enter
3. claude_desktop_config.json 파일을 메모장으로 열기 (파일이 없으면 새로 생성)

OS	전체 경로
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	C:\Users\{사용자이름}\AppData\Roaming\Claude\claude_desktop_config.json

MCP 서버 등록하기

설정 파일에 아래 내용을 추가합니다. 프로젝트 경로는 본인 환경에 맞게 수정하세요.

중요: Claude Desktop은 터미널의 PATH 환경변수를 사용하지 않습니다. command에는 반드시 전체 경로를 입력해야 합니다.

uv 전체 경로 확인: 터미널에서 which uv 실행

macOS 예시

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/full/path/to/uv",
      "args": ["run", "--directory", "/Users/사용자이름/projects/fastmcp-labs", "python", "main.py"]
    }
  }
}

Windows 예시

uv 전체 경로 확인: 명령 프롬프트에서 where uv 실행

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "C:\\full\\path\\to\\uv.exe",
      "args": ["run", "--directory", "C:\\Users\\사용자이름\\projects\\fastmcp-labs", "python", "main.py"]
    }
  }
}

프로젝트 경로 확인 방법

• macOS: 터미널에서 프로젝트 폴더로 이동 후 pwd 명령어 실행
• Windows: 파일 탐색기에서 프로젝트 폴더 열고 주소창의 경로 복사
  • 복사한 경로의 \를 \\로 변경 (예: C:\Users\... → C:\\Users\\...)

여러 MCP 서버 등록하기

여러 MCP 서버를 동시에 사용하려면 mcpServers 안에 여러 항목을 추가합니다:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/full/path/to/uv",
      "args": ["run", "--directory", "/path/to/fastmcp-labs", "python", "main.py"]
    },
    "another-server": {
      "command": "/full/path/to/uv",
      "args": ["run", "--directory", "/path/to/another-project", "python", "main.py"]
    }
  }
}

설정 적용

설정 파일 저장 후 Claude Desktop을 재시작하면 MCP 서버가 활성화됩니다.

사용 가능한 도구

도구	설명
greet	이름을 입력하면 인사 메시지 반환
current_time	현재 시간 조회