local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

References a tutorial video that demonstrates how to build and configure the MCP server.

MCP 서버 예제

이 저장소에는 교육용 모델 컨텍스트 프로토콜(MCP) 서버 구현이 포함되어 있습니다. 이 코드는 다양한 LLM 클라이언트와 통합 가능한 기능적인 MCP 서버를 구축하는 방법을 보여줍니다.

전체 튜토리얼을 따라하려면 YouTube 비디오 튜토리얼을 참조하세요.

MCP란 무엇인가요?

MCP(Model Context Protocol)는 애플리케이션이 LLM에 컨텍스트를 제공하는 방식을 표준화하는 개방형 프로토콜입니다. MCP는 AI 애플리케이션의 USB-C 포트와 같습니다. AI 모델을 다양한 데이터 소스 및 도구에 연결하는 표준화된 방식을 제공합니다.

주요 이점

LLM이 직접 연결할 수 있는 미리 구축된 통합 목록이 점점 늘어나고 있습니다.
LLM 공급자와 공급업체 간 전환의 유연성
인프라 내에서 데이터를 보호하기 위한 모범 사례

아키텍처 개요

MCP는 호스트 애플리케이션이 여러 서버에 연결할 수 있는 클라이언트-서버 아키텍처를 따릅니다.

MCP 호스트 : MCP를 통해 데이터에 액세스하려는 Claude Desktop, IDE 또는 AI 도구와 같은 프로그램
MCP 클라이언트 : 서버와 1:1 연결을 유지하는 프로토콜 클라이언트
MCP 서버 : 표준화된 모델 컨텍스트 프로토콜을 통해 특정 기능을 노출하는 경량 프로그램
데이터 소스 : MCP 서버가 액세스할 수 있는 로컬(파일, 데이터베이스) 및 원격 서비스(API)

핵심 MCP 개념

MCP 서버는 세 가지 주요 유형의 기능을 제공할 수 있습니다.

리소스 : 클라이언트가 읽을 수 있는 파일 유형의 데이터(API 응답이나 파일 콘텐츠 등)
도구 : LLM에서 호출할 수 있는 기능(사용자 승인 필요)
프롬프트 : 사용자가 특정 작업을 수행하는 데 도움이 되는 미리 작성된 템플릿

시스템 요구 사항

Python 3.10 이상
MCP SDK 1.2.0 이상
uv 패키지 관리자

시작하기

uv 패키지 관리자 설치

MacOS/Linux의 경우:

지엑스피1

uv 명령이 인식되도록 터미널을 다시 시작하세요.

프로젝트 설정

프로젝트를 생성하고 초기화합니다.

# Create a new directory for our project
uv init mcp-server
cd mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" httpx

서버 구현 파일을 만듭니다.

touch main.py

서버 실행

MCP 서버를 시작합니다.

uv run main.py

서버가 시작되고 연결을 수락할 준비가 됩니다.

Claude Desktop에 연결

공식 웹사이트에서 Claude Desktop을 설치하세요
MCP 서버를 사용하도록 Claude Desktop을 구성하세요.

~/Library/Application Support/Claude/claude_desktop_config.json 편집합니다.

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # It's better to use the absolute path to the uv command
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}