opentokenz/mcpx

해결하는 문제

MCPX는 개발자의 로컬 환경(워크스페이스, 소스 코드, 터미널 명령, 시스템 기능 등)을 ChatGPT, Claude, Cursor, Grok과 같은 AI 클라이언트에 안전하게 노출하기 위한 로컬 MCP(Model Context Protocol) 런타임 및 게이트웨이입니다. AI 모델이 보안을 희생하지 않고도 신뢰할 수 있고, 감사 가능하며 상태를 유지하는 방식으로 로컬 개발 자산과 상호작용할 수 있도록 하며, 다양한 클라이언트 세션 간에 컨텍스트를 잃는 문제도 해결합니다.

작동 방식

MCPX는 AI 클라이언트와 로컬 머신 사이의 미들웨어 역할을 합니다. Streamable HTTP를 사용하여 클라이언트와 통신하고, SQLite 데이터베이스를 통해 상태를 관리합니다. 주요 메커니즘은 다음과 같습니다:

• 원격 세션: remote_session_id를 사용해 워크스페이스 상태, 권한, 기록을 지속적으로 유지하여 모델이 다른 연결이나 클라이언트 간에 작업을 재개할 수 있도록 합니다.
• 워크스페이스 관리: 사용자는 특정 프로젝트 디렉터리를 워크스페이스로 등록하고, 런타임이 이를 세션에 바인딩합니다.
• 도구 오케스트레이션: 파일 읽기(sha-256 검증 포함), 파일 편집(일관성 있는 대체), 터미널 명령 실행(보안 정책 엔진 포함), 프로젝트 작업 관리 등의 핵심 도구를 제공합니다.
• 보안 레이어: 명령어(허용/확인/거부) 및 파일에 대해 엄격한 보안 정책을 구현하며, 원격 접근을 위해 OAuth, Bearer 토큰, ACL을 지원합니다.
• 확장 시스템: 로컬 "스킬"과 상류 MCP 서버를 탐지하고 통합할 수 있어, 모델이 이러한 도구를 호출할 수 있는 통합 인터페이스를 제공합니다.

대상 사용자

• 로컬 코드베이스와 터미널에 깊이 있고 안전하게 접근하고 싶은 AI 보조 개발자
• AI 에이전트가 소스 코드를 수정하거나 명령을 실행한 기록을 감사할 필요가 있는 팀
• MCP 호환 클라이언트(ChatGPT, Claude 등)를 사용하는 파워 유저로, 지속 가능하고 전문적인 로컬 런타임을 원하는 사용자

주요 특징

• 상태 유지 연속성: 지속적인 ID를 사용해 다양한 AI 클라이언트 간에 세션을 재개할 수 있습니다.
• 고정밀 편집: SHA 기반 리비전 가드와 정확한 대체를 통해 파일 손상 가능성을 방지합니다.
• 안전한 삭제: 두 단계의 move_out 프로세스(준비 → 확인 → 제출)를 통해 파일을 시스템 휴지통으로 이동시켜 영구 삭제를 방지합니다.
• 보안 우선 실행: 위험한 작업(예: git push, docker)에 대해 사용자 확인을 요구하는 세밀한 명령 정책 엔진을 제공합니다.
• 확장 가능한 아키텍처: 다른 MCP 서버 및 사용자 정의 로컬 스킬과 원활하게 통합 가능합니다.
• 환경 인식 능력: OS, 아키텍처, 툴체인에 대한 상세한 메타데이터를 모델에 제공합니다.