피드로 돌아가기
Dev.toDevOps
원문 읽기
GitHub PR 기반 컨벤션을 MCP Server로 Cursor AI에 실시간 동기화
Setting Up the Codehabits MCP Server in Cursor (5 Minutes)
AI 요약
Context
수동으로 관리하는 코딩 컨벤션 파일의 유지보수 오버헤드와 팀원 간 지식 파편화 발생. 정적인 룰 파일로는 변화하는 프로젝트 도메인 지식과 최신 패턴을 실시간으로 반영하기 어려운 한계 존재.
Technical Solution
- GitHub PR 이력에서 팀 컨벤션을 자동 추출하여 .codehabits/ 디렉토리에 정형 데이터로 저장하는 구조 설계
- Cursor AI와 외부 도구를 연결하는 Model Context Protocol(MCP) 기반의 전용 서버 구축
- get_team_context, check_code 등 6종의 전용 Tool을 제공하여 LLM이 필요 시점에 능동적으로 팀 지식을 조회하는 Explicit Lookup 방식 채택
- Agent Skills의 수동적 컨텍스트 로드와 MCP의 능동적 검증 로직을 병행하여 컨텍스트 정확도 향상
- .cursor/mcp.json 설정을 통한 팀 전체의 MCP 서버 구성 동기화 및 일관된 AI 동작 보장
Key Takeaway
문서화된 규칙이 아닌 실제 코드 변경 이력(Evidence-backed patterns)을 기반으로 AI 컨텍스트를 구성하여 지식의 최신성과 신뢰성 확보
실천 포인트
- 프로젝트 루트에 .codehabits/ meta.json 생성 여부 확인 - MCP 서버 설치 후 .cursor/mcp.json 파일을 Git으로 공유하여 팀 내 설정 통일 - 단순 컨텍스트 주입(Agent Skills)과 명시적 도구 호출(MCP)의 역할을 분리하여 프롬프트 설계 - 규칙 업데이트 시 npx @codehabits/cli sync 명령어를 통한 최신 패턴 동기화 수행