nakasyou/local-mcp

해결하는 문제

AI 에이전트가 로컬 머신의 파일 시스템에 안전하게 접근하고 명령을 실행할 수 있는 방법을 제공합니다. LLM의 능력과 로컬 시스템 접근 간의 격차를 메우면서, 에이전트가 호스트 컴퓨터에 완전하고 제한 없는 접근 권한을 부여하는 위험을 완화합니다.

작동 방식

이 프로젝트는 로컬 기능을 도구로 노출하기 위해 Model Context Protocol (MCP)를 구현합니다. 각 세션은 특정 작업 디렉터리와 연결된 세션 기반 시스템을 사용합니다. 보안을 위해 Linux에서는 Landlock/bubblewrap, macOS에서는 Seatbelt를 사용하여 명령을 격리하고 기본적으로 네트워크 접근을 차단합니다. 더 높은 권한이 필요한 작업의 경우, 사용자가 특정 작업에 대한 권한을 수동으로 부여하거나 취소할 수 있는 승인 시스템을 사용합니다. 또한 세션 내에서 제한 없이 접근할 수 있는 "yolo" 모드도 제공합니다.

대상 사용자

로컬 개발 환경과 파일 시스템에 AI 에이전트를 통합하고 싶지만 시스템 보안을 희생하고 싶지 않은 개발자와 사용자입니다.

주요 특징

• 안전한 명령 실행: Linux 및 macOS에서 OS 수준의 사전 격리 기능을 사용하여 명령을 격리합니다.
• 세션 관리: 각각 고유한 작업 디렉터리와 권한을 가진 여러 독립적인 세션을 지원합니다.
• 로컬 머신 기능: 파일 읽기, 여러 형식의 이미지 읽기, 디렉터리 목록 보기, 파일 쓰기 등의 도구를 제공합니다.
• 인터랙티브 승인: 권한 관리 및 실시간 활동 모니터링이 가능한 UI를 포함하며, 파일 편집에 대한 통합 차이(diff)도 표시합니다.
• 백그라운드 작업 처리: 작업 ID를 통해 장시간 실행되는 명령을 지원하며, 에이전트가 백그라운드 작업을 풀링하거나 중지할 수 있습니다.