MCP 서버 샘플

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

MCP 서버 예제

참고문헌:

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 패키지 관리자

설치

Python 프로젝트에 MCP 추가하기 Python 프로젝트를 관리하려면 uv를 사용하는 것이 좋습니다.

아직 uv 관리 프로젝트를 만들지 않았다면 하나 만드세요.

지엑스피1

그런 다음 프로젝트 종속성에 MCP를 추가합니다.

uv add "mcp[cli]

또는 종속성을 위해 pip를 사용하는 프로젝트의 경우:

pip install "mcp[cli]"

독립 실행형 MCP 개발 도구 실행 uv와 함께 mcp 명령을 실행하려면:

uv run mcp

빠른 시작

계산기 도구와 일부 데이터를 공개하는 간단한 MCP 서버를 만들어 보겠습니다.

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

Claude Desktop에 이 서버를 설치하고 다음을 실행하여 바로 상호 작용할 수 있습니다.

mcp install server.py

또는 MCP Inspector로 테스트할 수 있습니다.

mcp dev server.py

Antonio Scapellato 가 ❤️로 만들었습니다

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

MCP Server Sample

Integrations