MCP

개요

Model Context Protocol(MCP)
AI 모델과 외부 도구, 데이터 소스 간의 통신을 표준화하는 프로토콜
2023년 Anthropic에서 처음 제안
AI 시스템이 외부 세계와 효과적으로 상호작용할 수 있도록 설계

주요 특징

표준화된 통신: AI 모델과 외부 서비스 간의 통신 방식을 표준화
도구 확장성: 새로운 도구와 기능을 쉽게 AI 시스템에 통합 가능
컨텍스트 관리: 대화 컨텍스트를 효율적으로 관리하여 AI의 이해도 향상
멀티모달 지원: 텍스트뿐만 아니라 이미지, 오디오 등 다양한 형태의 데이터 처리 지원

작동 방식

MCP 주요 구성 요소:

MCP 서버: 외부 도구와 서비스를 호스팅하고 관리하는 서버
MCP 클라이언트: AI 모델이 MCP 서버와 통신하기 위한 인터페이스
도구 정의: 각 도구의 기능, 파라미터, 반환 값 등을 정의하는 스키마

text
AI 모델 <-> MCP 클라이언트 <-> MCP 서버 <-> 외부 도구/서비스

사용 사례

웹 브라우징: AI가 실시간으로 웹 페이지를 검색하고 정보를 추출
데이터 분석: 외부 데이터베이스나 API에서 데이터를 가져와 분석
코드 실행: 사용자가 제공한 코드를 안전한 환경에서 실행하고 결과 반환
IoT 제어: 스마트홈 기기 등 IoT 장치와 상호작용

구현 예시

기본 MCP 서버 구현 (Node.js)

javascript
const express = require('express');
const app = express();
app.use(express.json());

// 도구 정의
const tools = {
  calculator: {
    add: (a, b) => a + b,
    subtract: (a, b) => a - b,
    multiply: (a, b) => a * b,
    divide: (a, b) => a / b
  },
  weather: {
    getTemperature: (city) => {
      // 실제 구현에서는 날씨 API 호출
      return `${city}의 현재 온도는 22°C입니다.`;
    }
  }
};

// MCP 엔드포인트
app.post('/mcp', (req, res) => {
  const { tool, method, params } = req.body;
  
  if (!tools[tool] || !tools[tool][method]) {
    return res.status(400).json({ error: '유효하지 않은 도구 또는 메서드' });
  }
  
  try {
    const result = tools[tool][method](...params);
    res.json({ result });
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

app.listen(3000, () => {
  console.log('MCP 서버가 포트 3000에서 실행 중입니다.');
});

Python에서의 MCP 클라이언트 예시

python
import requests
import json

class MCPClient:
    def __init__(self, server_url):
        self.server_url = server_url
        
    def call_tool(self, tool, method, params):
        payload = {
            "tool": tool,
            "method": method,
            "params": params
        }
        
        response = requests.post(
            f"{self.server_url}/mcp", 
            json=payload
        )
        
        if response.status_code == 200:
            return response.json()["result"]
        else:
            error = response.json().get("error", "알 수 없는 오류")
            raise Exception(f"MCP 호출 실패: {error}")

# 사용 예시
client = MCPClient("http://localhost:3000")
result = client.call_tool("calculator", "add", [5, 3])
print(f"5 + 3 = {result}")  # 출력: 5 + 3 = 8

weather = client.call_tool("weather", "getTemperature", ["서울"])
print(weather)  # 출력: 서울의 현재 온도는 22°C입니다.

MCP 다이어그램 예시

text
graph TD
    A[Claude Desktop] <--> |MCP Protocol: Query and Result| B[SQLite MCP Server]
    B <--> |Local Access: SQL Operation| C[SQLite Database ~/test.db]
    
    style A fill:#e6e6ff,stroke:#9999ff
    style B fill:#e6e6ff,stroke:#9999ff
    style C fill:#e6f0ff,stroke:#99c2ff,stroke-width:2px
    
    subgraph Your Computer
    A
    B
    C
    end