SurgicalFS MCP 주요 업데이트 (v.0.6.0)
요약
Claude Desktop 및 웹 UI의 로컬 파일 시스템 접근 한계를 극복하기 위한 SurgicalFS MCP 서버의 v.0.6.0 업데이트 소식입니다. Rust 기반의 단일 바이너리로 구현되었으며, 강력한 파일 관리 기능과 정밀한 데이터 읽기, 상세한 토큰 및 성능 분석 대시보드를 제공합니다.
핵심 포인트
- Rust 기반 단일 바이너리로 제공되어 외부 의존성 없이 실행 가능
- Claude Code, Cursor, VS Code 등 다양한 MCP 지원 도구와 호환
- 토큰 분석, 지연 시간 히스토그램, 로그 뷰어 등 강력한 모니터링 기능
- JSON, CSV, PDF, DOCX 등 다양한 파일 형식의 네이티브 지원
GitHub에서 별 5개를 받았기 때문입니다. 농담이 아니라, 정말 단 하나도 기대하지 않았거든요. 그래서 이번 업데이트는 그 아름다운 분들에게 드리는 감사의 표시이기도 합니다. 어쨌든...
몇 달 전, 저는 Claude 웹 UI나 모바일에서 로컬 파일 시스템 (filesystem)에 접근할 수 없는 답답한 문제에 대한 해결책을 이곳에 게시한 적이 있으며, 동시에 Claude Desktop의 기본 파일 시스템 도구(Node.js 기반)의 단점들을 보완하고자 했습니다.
(원문 게시글: https://www.reddit.com/r/ClaudeAI/comments/1sh9m1k/for_the_claude_desktop_and_web_ui_crowd_a_much/)
초기 버전을 몇 달 동안 사용하며 한계까지 돌려본 결과, 더 즐거운 UX (사용자 경험)를 위한 멋진 UI를 포함하여 완전한 개편을 수행할 수 있는 충분한 데이터와 경험을 쌓았습니다.
단일 Rust 바이너리 (~9.37 MB), 47개의 도구 (tools), 정밀한 라인 범위 읽기 (surgical line-range reads), 서버 측 응답 예산 (server-side response budgets), ripgrep 검색, 네이티브 JSON/CSV/XLSX/PDF/DOCX 지원. 373개의 테스트를 완료했습니다. Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, Gemini, 그리고 MCP (Model Context Protocol)를 지원하는 그 어떤 것과도 함께 작동합니다 (인증 토큰 관리 기능도 포함되어 있습니다).
저는 SurgicalFS를 핵심 파일 서버 도구로 사용하여, 41개 폴더에 걸쳐 147 MB가 넘는 1,400개 이상의 거버넌스 및 개발 문서를 관리하며 MuSiQue 1,000Q에서 F1=0.677 점수를 기록한 Rust RAG 엔진 (~15 MB 바이너리)을 처음부터 성공적으로 구축했습니다. 이는 현재 제가 진행 중인 5개의 활성 프로젝트 중 하나일 뿐입니다.
(다른 서브레딧에도 RAG 엔진에 관한 글을 올렸으므로 이미 접하셨을 수도 있습니다)
Repo: https://github.com/wonker007/surgicalfs-mcpserver
주요 업데이트 사항:
→ 서버 안정성 및 프로세스 관리 (process management) 개선
→ 토큰 분석 (Token analytics): 도구별(per-tool) 및 리포지토리별(per-repo) 추적, 프레젠테이션(presentation) 대 콘텐츠(content) 분리, 일간/주간/월간 롤업 (rollups), JSONL 내보내기
→ 다중 기간 오버레이를 포함한 지연 시간 (Latency) 히스토그램 (5분/15분/1시간 vs 24시간 vs 7일)
→ 요청률 (request rate), 에러, RSS, 지연 시간에 대한 스파크라인 (Sparklines)
→ 구조화된 로그 (structured logs), 파일별 다운로드, 보관 주기 제어 (retention controls) 기능을 갖춘 로그 뷰어
→ 서버 재시작/중지, 인증 토큰 (auth token) 관리, 런타임 도구 토글링 (runtime tool toggling) — 이 모든 기능을 브라우저에서 수행 가능
→ 외부 의존성 제로 (Zero external dependencies) — 대시보드는 바이너리 자체에서 서빙됨
이 기능들이 제 프로젝트에 도움이 되었던 것처럼 여러분의 프로젝트에도 도움이 되기를 바랍니다.
submitted by /u/wonker007
[link] [comments]
AI 자동 생성 콘텐츠
본 콘텐츠는 r/ClaudeAI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기