MCP 서버 템플릿

권한 경계, 통합 테스트 및 평가 계약을 포함하는 프로덕션 수준의 MCP 서버 시작 템플릿입니다.

템플릿

템플릿	설명	주요 기능
basic	최소 MCP 서버	Echo + 계산 도구, Zod 유효성 검사
database	읽기 전용 데이터베이스 액세스	SQL 유효성 검사, 스키마 인트로스펙션, 권한 경계
api-gateway	외부 API 프록시	속도 제한, 자격 증명 범위 지정, 엔드포인트 구성

빠른 시작

이 저장소를 복제하거나 GitHub에서 "Use this template"을 사용하세요.
원하는 템플릿으로 이동합니다: cd templates/basic
종속성을 설치합니다: pnpm install
서버를 시작합니다: pnpm start

아키텍처

각 템플릿은 동일한 패턴을 따릅니다:

권한 엔진 — 모든 도구 호출 전에 평가되는 선언적 규칙(허용/거부)
인메모리 테스트 클라이언트 — MCP SDK의 InMemoryTransport를 통한 통합 테스트
평가 계약 — @visystems/claude-eval-runner와 호환되는 YAML 평가 사양

공유 유틸리티

shared/ 디렉토리에는 재사용 가능한 유틸리티가 포함되어 있습니다:

permissions/ — 권한 정책 유형, 엔진 및 PermissionDeniedError
testing/ — 통합 테스트를 위한 인메모리 MCP 테스트 클라이언트
errors/ — 유형이 지정된 오류 클래스

개발

pnpm install
pnpm typecheck    # TypeScript type checking
pnpm test         # Run all tests
pnpm test:shared  # Run shared utility tests only
pnpm test:basic   # Run basic template tests only