achetronic/filesystem-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
Give your AI access to the filesystem
개요
A production-ready MCP (Model Context Protocol) server that gives AI agents full control over a filesystem — reading, writing, editing, searching, diffing files, executing commands, and managing processes. Built in Go with OAuth authorization and RBAC. - 🗂️ for filesystem operations, shell execution, and agent utilities - 🔐 — restrict operations per path using glob patterns and JWT claim expressions - ⚡ — partial file reads, batch edits, ranged diffs, search with context control - 🔑 — .well-known/oauth-protected-resource and .well-known/oauth-authorization-server - 🛡️ — validated locally via JWKS + CEL expressions - 🚀 — stdio for local clients, HTTP for remote (Claude Web, OpenAI, etc.) RBAC controls which operations are allowed on which filesystem paths. Rules are evaluated in order — first match wins. system_info and scratch don't touch the filesystem and are always allowed. - — CEL expressions evaluated against the JWT payload. All must be true (AND).
README
원문 README의 일부입니다. 원문 보기.
A production-ready MCP (Model Context Protocol) server that gives AI agents full control over a filesystem — reading, writing, editing, searching, diffing files, executing commands, and managing processes. Built in Go with OAuth authorization and RBAC.
Features
- 🗂️ 12 powerful tools for filesystem operations, shell execution, and agent utilities
- 🔐 RBAC with JWT + CEL — restrict operations per path using glob patterns and JWT claim expressions
- ⚡ Token-efficient by design — partial file reads, batch edits, ranged diffs, search with context control
- 🔑 OAuth RFC 8414 / RFC 9728 compliant —
.well-known/oauth-protected-resourceand.well-known/oauth-authorization-server - 🛡️ JWT validation — validated locally via JWKS + CEL expressions
- 🚀 Dual transport — stdio for local clients, HTTP for remote (Claude Web, OpenAI, etc.)
Tools
Filesystem
| Tool | Description |
|---|---|
ls |
List directory contents with depth, glob filter, hidden file toggle. depth=1 is flat, depth=N is tree |
read_file |
Read a file fully or specific line ranges. Accepts an array of {offset, limit} ranges for partial reads |
write_file |
Create or overwrite a file. Auto-creates parent directories. Saves undo state |
edit_file |
Batch find-and-replace on a file. Accepts an array of {old_text, new_text, replace_all} edits applied sequentially. Reports successes and failures |
search |
Recursive grep with regex or literal mode. Configurable include/exclude patterns, context lines, max results |
diff |
Unified diff between two files or sections. Supports line ranges on both sides |
Shell & Processes
| Tool | Description |
|---|---|
exec |
Execute shell commands in foreground (with timeout) or background (returns process ID) |
설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →