설명
MCP 로컬 감사자 및 시스템 설계자 V2는 개발자의 머신에서 완전히 실행되는 언어 모델을 사용하여 코드 및 시스템 설계를 검토하는 오픈 소스 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 모든 MCP 호환 클라이언트에 연결되어 제출물을 클라우드 API 대신 로컬 LM 스튜디오 서버에 전달하므로 코드나 설계가 머신을 벗어나지 않으며, 토큰 비용이 발생하지 않습니다.
더 읽기
서버는 들어오는 제출물이 코드인지 고수준 사양인지 자동으로 감지하고 이를 두 가지 역할 중 하나로 라우팅합니다. 프로덕션 코드 감사자 모드에서는 입력을 10개의 방어적 엔지니어링 규칙에 따라 검사하여 null 체크 및 0으로 나누기와 같은 논리 및 엣지 조건, 닫히지 않은 컨텍스트 관리자와 같은 리소스 누수 및 성능 문제, 타입 힌트 및 제한된 루프 가드와 같은 방어적 경계를 포함합니다. 이 모드는 실행 가능한 피드백과 함께 결정론적인 승인 또는 거부 판정을 반환합니다. 시스템 설계자 및 전략가 모드에서는 입력이 코드가 아닌 사양처럼 보일 때 활성화되어 구성 요소 토폴로지, 디렉터리 구조, 동시성 및 실패 지점에 대한 위험 모델링, 단계적 실행 계획을 생성합니다.
언어 모델에 도달하기 전에 빠른 AST 기반의 센티넬이 제출물을 파싱하고 eval, exec, os.system 및 subprocess와 같은 고위험 호출을 차단하며 잘못된 Python 코드는 즉시 거부합니다. 모든 감사는 두 번 기록됩니다: 메트릭 및 이력을 위한 로컬 SQLite 데이터베이스의 구조화된 행으로, 그리고 미세 조정 데이터셋으로 사용될 수 있는 원자 JSON 로그로 기록됩니다. 별도의 감시 스크립트는 서버와 함께 실행되어 새로운 감사 파일이 생성될 때 Discord 채널에 형식화된 상태 업데이트를 게시할 수 있어 팀이 대시보드를 열지 않고도 검토 활동을 따를 수 있습니다. 서버는 또한 LM 스튜디오의 활성 모델 엔드포인트에 직접 쿼리하여 현재 로드된 모델을 자동으로 선택하므로 하드코딩된 모델 이름이 필요하지 않습니다.
이 프로젝트는 개발자가 코드 변경 후 감사 도구를 호출하도록 구성된 "에이전트 루프 프로토콜" 스니펫을 제공하여, 거부 피드백을 읽고 보고된 문제를 수정한 후 재제출할 수 있도록 하며, 최대 5회 시도로 제한됩니다.
이 도구는 클라우드 추론 비용을 지불하지 않고 제3자 API에 독점 코드를 노출하지 않으면서 MCP 기반 코딩 워크플로우에서 자동화된 코드 및 아키텍처 검토 단계를 원하는 개인 개발자 및 소규모 팀을 위해 설계되었습니다. Python 3.10 이상, 지침 조정 모델이 로드된 LM 스튜디오 인스턴스, MCP 호환 클라이언트가 필요합니다. 이 프로젝트는 MIT 라이센스 하에 배포되며 무료로 사용 가능합니다. 유지 관리자는 Ko-fi 및 GitHub Sponsors를 통해 선택적 기부를 받습니다.
- 카테고리AI 코드 리뷰 및 테스트
- 요금제오픈소스
- 배포로컬 실행
- 플랫폼Windows, macOS, Linux
MCP 로컬 감사자 및 시스템 설계자 V2의 핵심 기능
코드와 사양 입력을 자동으로 감지하고 일치하는 감사 역할로 라우팅하는 이중 모드 MCP 서버
프로덕션 코드 감사자 모드는 결정론적인 승인/거부 판정으로 제출물을 10개의 방어적 엔지니어링 규칙에 따라 검사합니다.
시스템 설계자 및 전략가 모드는 사양에서 구성 요소 토폴로지, 위험 모델 및 단계적 실행 계획을 작성합니다.
AST 기반 센티넬이 eval, exec, os.system 및 subprocess 호출을 차단하고 모델에 도달하기 전에 잘못된 Python을 거부합니다.
로컬 LM 스튜디오 서버에서 완전히 실행되므로 코드가 개발자의 머신을 벗어나지 않으며 토큰 비용이 없습니다.
동적 모델 발견이 LM 스튜디오에서 현재 로드된 모델을 읽습니다.
모든 감사를 로컬 SQLite 데이터베이스와 미세 조정 데이터셋에 적합한 원자 JSON 파일에 기록합니다.
백그라운드 Discord 감시자가 새로운 감사 결과가 작성될 때 실시간 형식화된 업데이트를 게시합니다.
코딩 어시스턴트가 반복적인 감사 및 수정 주기를 통해 스스로 수정하도록 만드는 "에이전트 루프 프로토콜" 프롬프트 스니펫을 제공합니다.
라이브 LM 스튜디오 인스턴스 없이 AST 보호, 데이터베이스 마이그레이션 및 추론 파이프라인을 검증하는 pytest 스위트를 포함합니다.
MCP 로컬 감사자 및 시스템 설계자 V2 시작하기
LM 스튜디오 설치: LM 스튜디오를 다운로드하고, 지침 조정 모델을 로드한 후 포트 1234에서 로컬 서버를 시작합니다.
서버 복제 및 설정: 리포지토리를 복제하고 가상 환경을 생성한 후 pip로 종속성을 설치합니다.
MCP 서버 등록: MCP 클라이언트의 mcpServers 구성 파일에 서버의 브리지 스크립트 경로를 추가합니다.
감사 실행: 감사 도구를 통해 코드 또는 사양을 제출합니다. 서버는 자동으로 코드 감사자 또는 설계자 모드를 선택합니다.
판정 검토: 승인 또는 거부 상태와 피드백을 읽고, 거부된 경우 수정 후 재제출합니다.
선택 사항, 활동 감시: 감시 스크립트를 실행하여 새로운 감사 결과에 대한 Discord 알림을 받습니다.
MCP 로컬 감사자 및 시스템 설계자 V2의 사용 사례
- 로컬 코드 검토 게이트
- 아키텍처 계획
- 자기 수정 코딩 에이전트
- 팀 감사 가시성
