opentokenz/mcpx

해결하는 문제

MCPX는 로컬 개발 환경을 위한 안전하고 감사 가능하며 지속 가능한 게이트웨이(MCP Runtime)를 제공합니다. ChatGPT, Claude, Cursor, Grok과 같은 AI 클라이언트가 보안을 희생하지 않고도 로컬 워크스페이스, 소스 코드, 터미널, 외부 MCP 서버에 접근할 수 있으며, 다양한 클라이언트 연결 간에도 세션 상태를 잃지 않습니다.

작동 방식

MCPX는 AI 클라이언트와 로컬 머신 사이의 미들웨어 역할을 합니다. Streamable HTTP 전송을 사용하여 모델에 핵심 및 보조 도구 세트를 노출합니다. 주요 메커니즘은 다음과 같습니다:

• 원격 세션: SQLite에 영구 저장된 remote_session_id를 사용하여, 다양한 클라이언트 연결 간에 상태(역할, 권한, 작업, 계획)를 유지합니다.
• 워크스페이스 관리: 사용자는 로컬 프로젝트 디렉터리를 워크스페이스로 등록하며, 런타임은 이를 특정 세션에 바인딩합니다.
• 제어된 접근: 명령어 및 파일에 대한 엄격한 보안 정책(허용/확인/거부)을 구현하고, 파일 삭제와 같은 파괴적 작업은 '준비 및 제출' 두 단계 프로세스를 사용합니다(실제로는 시스템 휴지통으로 이동).
• 도구 오케스트레이션: SHA-256 체크섬을 사용해 일관성을 보장하는 파일 읽기, 정확한 대체를 통한 파일 편집, 터미널 명령어 실행, 장시간 실행 작업 관리를 통합된 인터페이스로 제공합니다.
• 확장 기능 통합: 로컬 '스킬'과 상류 MCP 서버를 관리하며, 내부적으로 리비전과 스키마를 처리하여 모델이 항상 올바른 버전을 사용할 수 있도록 합니다.

대상 사용자

로컬 코드베이스와 시스템 도구에 깊이 있고 안전하게 접근하고 싶으면서도, 완전한 감사 기록을 유지하고 다양한 AI 인터페이스 간에 세션을 복원할 수 있는 개발자.

주요 특징

• 지속적인 상태: 원격 세션을 통해 일관된 세션 ID를 사용해 다양한 클라이언트 간에 작업을 재개할 수 있습니다.
• 보안 최우선: 세부적인 명령어 정책과 파일 삭제에 대한 필수적인 두 단계 확인 프로세스.
• 감사 가능성: 모든 도구 호출, 터미널 작업, 파일 편집은 로그에 기록되며, 로컬 소켓 또는 observe 도구를 통해 관찰 가능합니다.
• 모델 친화적 프로토콜: 파일 편집에 SHA-256 리비전 가드를 사용하고, 의도와 실행을 분리하는 구조화된 "Activity" 추적을 채택합니다.
• 광범위한 통합: 웹 기반 AI 클라이언트(예: ChatGPT)에서 안전한 원격 접근을 OAuth 2.1 + PKCE로 지원합니다.