MCP Spine: LLM과 도구 사이의 보안 및 제어를 위한 미들웨어 프록시

섹션별 상세

여러 MCP 서버를 단일 엔트리 포인트로 통합하여 관리 복잡성을 해소한다. 개별 서버 설정을 Spine 하나로 대체함으로써 클라이언트 측의 부하를 줄이고 중앙 집중식 제어가 가능해진다. 이를 통해 50개 이상의 도구를 연결하더라도 안정적인 운영 환경을 구축할 수 있다.

MCP Spine의 CLI 실행 및 동작 과정을 보여주는 데모 애니메이션 — Screenshot터미널에서 Spine 서버가 구동되고 클라이언트와 연결되는 과정을 보여준다. 시스템 진단(doctor) 명령과 서버 실행 과정을 통해 실제 사용 흐름을 파악할 수 있다.

시맨틱 라우팅과 스키마 축소를 통해 LLM 운영 비용을 획기적으로 낮춘다. 로컬 벡터 DB인 ChromaDB를 사용하여 질문에 필요한 도구만 선별적으로 노출하며, 스키마 축소 레벨 2 적용 시 약 61%의 토큰 절감 효과를 거둔다. 이는 컨텍스트 윈도우가 제한적인 모델을 사용할 때 특히 유용하다.

json

{
  "mcpServers": {
    "spine": {
      "command": "python",
      "args": ["-m", "spine.cli", "serve", "--config", "/path/to/spine.toml"],
      "cwd": "/path/to/mcp-spine"
    }
  }
}

Claude Desktop 설정 파일에서 여러 MCP 서버를 Spine 프록시 하나로 통합하는 예시

근거

스키마 축소 레벨 2 적용 시 61%의 토큰 절감 효과를 달성했다. — Features - Schema Minification (Stage 3) 섹션
로컬 벡터 임베딩을 위해 all-MiniLM-L6-v2 모델을 사용하며 외부 API 호출 없이 작동한다. — Features - Semantic Router (Stage 2) 섹션

강력한 보안 레이어를 제공하여 LLM의 오작동이나 공격으로부터 시스템을 보호한다. 비밀번호나 API 키 같은 민감 정보 자동 마스킹, 경로 이탈 방지(Jail), 프롬프트 주입 탐지 기능을 포함한다. 특히 파괴적인 도구 호출 시 인간의 승인을 요구하는 HITL(Human-in-the-Loop) 기능을 지원한다.

toml

[minifier]
level = 2

[token_budget]
daily_limit = 500000
warn_at = 0.8
action = "warn"

Spine 설정 파일에서 스키마 축소 레벨과 일일 토큰 예산을 설정하는 예시

실시간 모니터링을 위한 웹 대시보드와 상세한 감사 로그 기능을 지원한다. 브라우저 기반 대시보드에서 도구 호출 빈도, 보안 이벤트, 토큰 절감 수치, 서버 지연 시간을 시각적으로 확인할 수 있다. 모든 활동은 HMAC 지문이 포함된 SQLite DB에 기록되어 사후 분석 및 규정 준수 확인에 활용된다.

MCP Spine의 웹 기반 모니터링 대시보드 화면 — Chart도구 호출 횟수, 보안 이벤트, 세션 수, 토큰 예산 사용량 및 절감 수치(43.3%)를 한눈에 보여준다. 하단에는 최근 도구 호출 로그와 클라이언트 세션 정보가 상세히 표시된다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol): — LLM이 데이터 소스 및 도구와 상호작용하기 위한 개방형 표준 프로토콜이다. 서버와 클라이언트 간의 인터페이스를 표준화하여 다양한 도구를 모델에 쉽게 연결할 수 있게 한다.
시맨틱 라우팅(Semantic Routing): — 사용자의 질문 의도를 벡터 임베딩으로 분석하여 가장 관련성이 높은 도구만 선택적으로 모델에 전달하는 기술이다. 불필요한 도구 정보를 제외해 토큰 소모를 줄이고 정확도를 높인다.
스키마 축소(Schema Minification): — 도구의 기능 정의(JSON Schema)에서 필수적이지 않은 필드를 제거하여 데이터 크기를 줄이는 기법이다. LLM의 컨텍스트 윈도우를 효율적으로 사용하고 비용을 절감하는 데 기여한다.
인간 개입형 시스템(Human-in-the-Loop): — AI가 특정 작업을 수행하기 전 인간의 승인을 받도록 설계된 구조이다. 파일 삭제나 데이터베이스 수정 같은 파괴적인 작업의 안전성을 보장하기 위해 사용된다.

기술

Python
ChromaDB
SQLite
sentence-transformers
Claude Desktop

활용 사례

다수의 MCP 서버 통합 관리
LLM 도구 호출 보안 감사 및 승인 워크플로
API 비용 최적화를 위한 스키마 압축

언급된 리소스

GitHubMCP Spine GitHub Repository