Filesystem MCP π
@Tabeeh
Node.js Model Context Protocol (MCP) server providing secure, relative filesystem access for AI agents like Cline/Claude.
Overview
What is Filesystem MCP?
Filesystem MCP is a Node.js Model Context Protocol (MCP) server that provides secure, relative filesystem access for AI agents such as Cline and Claude.
How to use Filesystem MCP?
Clone the repository, install dependencies with npm install, then start the server with npm start. Modify config.json to configure the port, security settings, and allowed agents. Access the filesystem via HTTP endpoints like GET /files/{path} and POST /files/{path}.
Key features of Filesystem MCP
- Secure relative filesystem access for AI agents
- Designed for Cline and Claude
- Built with Node.js and TypeScript support
- Configuration via
config.jsonfile - HTTP API with GET and POST endpoints
Use cases of Filesystem MCP
- Allow AI agents to read files from a safe, sandboxed directory
- Enable AI agents to create or update files using relative paths
- Provide a controlled filesystem interface for agent workflows
FAQ from Filesystem MCP
What runtime does Filesystem MCP require?
Node.js version 16.0.0 or higher.
Which AI agents are supported?
The server is specifically designed to work with Cline and Claude.
How do I configure the server?
Edit the config.json file to set the port, enable security, and specify allowed agents.
How do I access files?
Use GET /files/{path} to read a file and POST /files/{path} with a JSON body containing content to write a file.
What happens if a file is not found or access is denied?
The server returns HTTP status 404 Not Found for missing files and 403 Forbidden for denied access.