컨텍스트 관리자 MCP 서버
개발 컨텍스트 및 워크플로를 관리하기 위한 MCP(모델 컨텍스트 프로토콜) 서버 구현입니다.
특징
- 안정적인 메시지 프레이밍을 통한 소켓 기반 전송
- 전체 JSON-RPC 2.0 프로토콜 지원
- 기능 협상을 통한 세션 관리
- 확장 가능한 도구 레지스트리 시스템
- 프로젝트, 작업 패키지 및 작업 관리
- 체크포인트 및 복원 기능
- QA 검토 워크플로 지원
초기 설정
지엑스피1
용법
서버 시작
# Development mode (no build required, uses tsx for on-the-fly compilation)
npm run dev
# Production mode (requires build)
npm start
# Start with debug logging
DEBUG=1 npm run dev
# Start on specific port
MCP_PORT=44558 npm run dev
개발 모드
# Run with hot reloading (preferred during development)
npm run dev
# Watch mode for TypeScript compilation (if you prefer running the compiled version)
npm run watch
# In a separate terminal when using watch mode
npm start
클린 스타트
문제가 발생하면 깨끗한 빌드를 시도해 보세요.
# Remove build artifacts
rm -rf dist/
# Reinstall dependencies
npm ci
# Rebuild the project
npm run build
# Start in development mode
npm run dev
건축학
핵심 구성 요소
- 메시지 프레이밍
- 콘텐츠 길이 기반 프로토콜
- 안정적인 메시지 경계 처리
- 버퍼 관리
- 전송 계층
- TCP 소켓 기반 통신
- 연결 관리
- 이벤트 기반 아키텍처
- 세션 관리
- 도구 레지스트리
도구
- 프로젝트 관리
- 프로젝트 생성/가져오기
- 프로젝트 체크포인트
- 국가 회복
- 작업 패키지 관리
- 작업 패키지 생성/가져오기
- 진행 상황 추적
- 상태 업데이트
- 작업 관리
- 작업 생성/업데이트
- 파일 변경 추적
- 작업 체크포인팅
- QA 도구
구성
환경 변수:
DEBUG
: 디버그 로깅 활성화(0/1)MCP_PORT
: 서버 포트(기본값: 44557)
규약
서버는 JSON-RPC 2.0을 사용하여 모델 컨텍스트 프로토콜을 구현합니다.
interface MCPMessage {
jsonrpc: "2.0";
id: number;
method?: string; // for requests
params?: any; // for requests
result?: any; // for responses
error?: { // for error responses
code: number;
message: string;
data?: any;
};
}
메시지 흐름
- 클라이언트는 TCP를 통해 연결됩니다
- 클라이언트가 초기화 요청을 보냅니다.
- 서버가 기능으로 응답합니다.
- 정상적인 메시지 교환이 시작됩니다
- 클라이언트가 종료/종료할 수 있습니다.
개발
위의 초기 설정 및 개발 모드 섹션을 참조하세요.
기여하다
- 저장소를 포크하세요
- 기능 브랜치를 생성하세요
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
특허
ISC 라이센스