xyTom/coding-tools-mcp

What it solves

Coding Tools MCP는 AI 에이전트가 로컬 코드베이스와 상호작용할 수 있도록 안전하고 모델 중립적인 런타임을 제공합니다. 각 AI 채팅 클라이언트나 에이전트 프레임워크가 자체적인 파일 시스템 및 셸 액세스 도구를 구현할 필요가 없도록 하며, 제한된 워크스페이스 내에서 파일을 읽고, 패치하고, 명령을 실행할 수 있는 검증된 18개의 표준화된 도구 세트를 제공합니다.

How it works

이 프로젝트는 Model Context Protocol (MCP)를 구현하여, Claude Desktop, Cursor 또는 VS Code와 같은 모든 MCP 호환 클라이언트가 구동할 수 있는 서버 역할을 수행합니다. AI 에이전트가 특정 디렉토리에만 국한되도록 제한하는 워크스페이스 기반 런타임으로 작동하여, 승인되지 않은 파일 액세스나 디렉토리 트래버설을 방지합니다. stdio 및 HTTP 전송 방식을 모두 지원하며, 네트워크 액세스, 셸 확장 및 파괴적인 명령을 제어하기 위한 권한 모드(safe, trusted, and dangerous`)를 포함합니다.

Who it’s for

• AI Agent Developers: 직접 도구를 만드는 대신 프로덕션 수준의 안전한 파일 및 실행 도구를 원하는 커스텀 에이전트 루프 구축 개발자.
• AI Chat Users: Claude Desktop 또는 Gemini CLI와 같은 도구를 사용하여 채팅 인터페이스를 직접적인 저장소 액세스 권한을 가진 코딩 에이전트로 전환하고자 하는 사용자.
• Security-Conscious Developers: 제공되는 Docker 샌드박스 또는 Linux에서의 커널 수준 Landlock 격리를 사용하여 신뢰할 수 없는 코드에서 AI 에이전트를 실행해야 하는 개발자.

Highlights

• Model-Neutral: 벤더에 관계없이 모든 LLM 또는 MCP 클라이언트와 작동합니다.
• Security-First: 워크스페이스 격리, 권한 모드, Linux에서의 Landlock 커널 수준 파일 시스템 격리 기능을 제공합니다.
• Comprehensive Toolset: 파일 읽기/검색, 구조화된 다중 파일 패치, Git 작업 및 대화형 명령 세션(REPL/debugger)을 위한 도구를 포함합니다.
• Context-Window Optimized: 토큰 사용량과 직렬화된 도구 결과 바이트를 줄이기 위해 결과가 요약 및 페이지화됩니다.
• Flexible Deployment: uvx 또는 npx를 통해 로컬에서 실행하거나, 인증된 HTTPS 터널을 통해 원격 서버로 실행하거나, 일회성 Docker 샌드박스에서 실행할 수 있습니다.