SpecLock: AI 코딩 제약 조건을 강제하는 MCP 서버

SpecLock은 세션 간에 프로젝트 제약 조건을 기억하고 AI 코딩 에이전트가 이를 위반하는 것을 차단하는 MCP 서버입니다. MIT 라이선스 하에 무료 오픈소스 도구로 이용 가능합니다.

SpecLock 작동 방식

이 도구는 의미적 이해를 통해 제약 조건 위반을 포착합니다. 소스 코드의 예시에 따르면 다음과 같은 것을 감지할 수 있습니다:

• 동의어 ("로그인 페이지에 소셜 로그인 추가"에서 login → auth)
• 완곡 표현 ("인증 흐름을 간소화"에서 streamline → modify)
• 시간적 회피 ("테스트를 위해 MFA를 일시적으로 비활성화")
• 복합 문장에 숨겨진 위반 ("UI 업데이트 및 사용자 테이블 삭제")

성능 및 테스트

Claude는 자체 적대적 테스트 스위트로 SpecLock을 독립적으로 테스트했습니다: 7개 스위트, 총 100개 테스트. 이 도구는 오탐률 0, 누락된 위반 0으로 100/100 점수를 기록했습니다. 각 제약 조건 검사는 평균 15.7ms가 소요됩니다.

설정 및 구성

Claude Code에서 MCP 서버로 SpecLock을 사용하려면 .mcp.json 파일에 다음 구성을 추가하세요:

{
  "mcpServers": {
    "speclock": {
      "command": "npx",
      "args": ["-y", "speclock", "serve", "--project", "."]
    }
  }
}

설치

npm을 통해 설치: npm install speclock. 이 도구는 42개의 MCP 도구를 포함하며 GitHub에서 github.com/sgroy10/speclock에서 이용 가능합니다.