이 저장소는 『MCP 실전활용 & 서버개발 핵심 가이드』 도서의 내용을 바탕으로 MCP(Model Context Protocol) 서버의 환경을 설정하고 사용하는 핵심 방법을 담고 있습니다. 환경 설정부터 실제 서버 사용법에 이르기까지, 개발이 완료된 MCP 서버를 활용하는 전체 과정은 아래의 가이드 영상을 통해 상세히 확인하실 수 있습니다.
- Yes24: https://www.yes24.com/product/goods/162224477
- 교보문고 : https://product.kyobobook.co.kr/detail/S000218318818
- 알라딘 : https://www.aladin.co.kr/shop/wproduct.aspx?ItemId=375653043
1. MCP 서버 환경 설정
MCP 서버 프로젝트를 시작하기 위한 기본 환경을 구축하는 방법입니다. Python 가상 환경 설정, 필수 라이브러리 설치, MCP 서버 코드 Clone 부터 Fast MCP 설치까지 단계별 안내를 제공합니다.
Pandas라이브러리를 활용하여 개발된 MCP 서버를 활용해 로컬에 저장되어있는 데이터를 분석하는 방법을 안내합니다.
구글의 API를 이용하여 개발되어진 MCP 서버를 활용하는 방법을 소개하며, 구글의 캘린더와 이메일을 통합해 MCP로 사용하는 방법을 안내합니다.
전자 공시 시스템의 데이터를 활용하는 MCP 서버로, 기업의 공시 정보를 수집하고 분석하는 방법을 설명합니다.
주식 거래 API와 연동한 MCP 서버 구축 예제로, 주식 매수 및 잔고 조회 기능을 MCP 서버로 사용하는 사례를 다룹니다.
FastMCP 버전 2.10.3을 기준으로 서버 설치 명령어의 형식이 변경되었습니다.
-
명령어 형식:
fastmcp install <파일 이름> -
특징: 버전 2.10.3 이전까지는 설치 대상이 Claude Desktop인 경우, 클라이언트 이름 명시 없이 파일 이름만으로 서버 설치가 가능했습니다.
예시:
fastmcp install server.py
-
명령어 형식:
fastmcp install <클라이언트 이름> <파일 이름> -
특징: 버전 2.10.3부터 여러 MCP 클라이언트가 지원됨에 따라, 설치 대상이 어떤 클라이언트용 서버인지 명확하게 지정해야 합니다. 따라서, 설치 명령어에 클라이언트 이름을 포함하는 것이 필수가 되었습니다.
-
주의: 이제
fastmcp install명령어에 클라이언트 이름을 포함하지 않으면 오류가 발생합니다.예시 (Claude Desktop용 서버 설치 시):
fastmcp install claude-desktop server.py
FastMCP 서버를 설치하고 실행하기 위한 기본적인 워크플로우입니다.
- 필수: 파이썬이 시스템에 우선적으로 설치되어 있어야 합니다.
- 확인: 터미널 또는 명령 프롬프트에서 아래 명령어를 입력하여 설치 및 버전을 확인하세요.
python --version
requirements.txt파일이 있는 폴더에 접근하여 필요한 라이브러리를 설치합니다.python -m pip install -r requirements.txt
- 가상 환경 생성: 프로젝트 폴더 내에
venv라는 이름의 가상 환경을 생성합니다.python -m venv venv
- 가상 환경 활성화: 생성된 가상 환경을 활성화합니다.
.\venv\Scripts\activate # Windows (명령 프롬프트/PowerShell) # source venv/bin/activate # macOS/Linux (Bash/Zsh)
- FastMCP 패키지 설치: 활성화된 가상 환경 내에
fastmcp를 설치합니다.pip install fastmcp
- 각 MCP 서버 파일을 설치할 때, 아래와 같은 명령어로 설치를 완료합니다.
fastmcp install claude-desktop <MCP서버 파일 이름>