MCP 서버 실전 운영 (2편) - Private Git 연동과 자동화

import os
import subprocess
from pathlib import Path

class GitContentSync:
    def __init__(self, repo_url: str, content_dir: str = "/tmp/blog-content"):
        # PAT로 인증 URL 생성
        gh_token = os.getenv("GH_PAT", "")
        if gh_token:
            self.repo_url = repo_url.replace("https://", f"https://{gh_token}@")

        self.content_dir = Path(content_dir)

    def initialize(self) -> bool:
        """서버 시작 시 Git Clone"""
        env = os.environ.copy()
        env['GIT_TERMINAL_PROMPT'] = '0'

        result = subprocess.run([
            "git", "clone", "--depth", "1",  # 최근 커밋만
            self.repo_url, str(self.content_dir)
        ], env=env, timeout=60)

        return result.returncode == 0

    def pull(self) -> bool:
        """Webhook 수신 시 Git Pull"""
        result = subprocess.run([
            "git", "-C", str(self.content_dir),
            "pull", "origin", "master"
        ], timeout=30)

        return result.returncode == 0

sequenceDiagram
    participant Dev as 개발자
    participant Git as GitHub
    participant MCP as MCP Server
    participant Store as Local Storage

    Dev->>Git: git push origin master

    Note over Git: Push 이벤트 발생

    Git->>MCP: POST /webhook/github + HMAC 서명

    Note over MCP: HMAC 검증 (보안)

    MCP->>Store: git pull origin master

    Note over Store: 최신 코드로 업데이트

    Store-->>MCP: Pull 완료
    MCP-->>Git: 200 OK

    Note over MCP: 새로운 포스팅 즉시 AI가 읽기 가능

from fastapi import FastAPI, Request, Header, HTTPException
import hmac
import hashlib

app = FastAPI(title="MCP REST API")
git_sync = GitContentSync(repo_url="https://github.com/user/private-blog.git")

@app.on_event("startup")
async def startup_event():
    """서버 시작 시 Git Clone"""
    git_sync.initialize()

@app.post("/webhook/github")
async def github_webhook(
    request: Request,
    x_hub_signature_256: str = Header(None)
):
    """GitHub Webhook 수신"""
    payload_bytes = await request.body()

    # HMAC 서명 검증
    webhook_secret = os.getenv("WEBHOOK_SECRET", "")
    expected_signature = "sha256=" + hmac.new(
        webhook_secret.encode(),
        payload_bytes,
        hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(expected_signature, x_hub_signature_256):
        raise HTTPException(status_code=401, detail="Invalid signature")

    # Git Pull 실행
    success = git_sync.pull()
    return {"success": success}

FROM python:3.11-slim

WORKDIR /app

# Git 설치 (필수!)
RUN apt-get update && apt-get install -y git

# Python 의존성
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 소스 코드
COPY src/ ./src/

# 임시 디렉토리 생성
RUN mkdir -p /tmp/blog-content

EXPOSE 8001

CMD ["python", "-m", "uvicorn", "src.rest_api:app", "--host", "0.0.0.0", "--port", "8001"]

name: Deploy MCP Server

on:
  push:
    paths:
      - 'mcp-server/**'

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Deploy to Cloud Run
        run: |
          gcloud run deploy mcp-api-server \
            --image gcr.io/$PROJECT_ID/mcp-api-server \
            --memory 512Mi \
            --min-instances 0 \
            --max-instances 5

# 카테고리별 포스팅 개수 수동 계산
find content/blog -name "*.md" | xargs grep "category: Spring" | wc -l
# 20분 소요

나: "블로그 통계 보여줘"

AI:
1. get_stats() 호출
2. 결과를 자연어로 정리

AI: "총 54개의 포스팅이 있습니다.

     카테고리별 분포:
     - Spring: 15개 (27.8%)
     - Java: 8개 (14.8%)
     - AI: 7개 (13.0%)

     인기 태그:
     1. JPA (12개)
     2. Performance (9개)"

--min-instances 1 # 항상 1개 인스턴스 유지 (월 $5 추가)