MCP Filesystem Server
philgei
README
MCP Filesystem Server
DISCLAIMER: This is an unofficial port of Claude's filesystem MCP server implementation, created solely as a Proof of Concept (POC). This project is not affiliated with Anthropic and should not be used in production environments. It was created to demonstrate and explore MCP server functionality.
The original implementation and concept were demonstrated by Claude (Anthropic) during interactive sessions. This port serves educational purposes only.
Quick Start
- Install using UVX:
uv venv
.venv\Scripts\activate # On Windows
uv pip install -e .
Usage with Claude Desktop
- Edit your
claude_desktop_config.json:
{
"mcpServers": {
"myFiles": {
"command": "mcp-server-filesystem",
"args": [
"D:/" // Replace with your desired directory
]
}
}
}
You can add multiple directories:
{
"mcpServers": {
"myFiles": {
"command": "mcp-server-filesystem",
"args": [
"D:/",
"C:/Users/YourUsername/Documents",
"~/Desktop"
]
}
}
}
-
Restart Claude Desktop to apply changes
-
In Claude Desktop:
- Click the paperclip icon
- Select the MCP menu (two electrical plugs connecting)
- Your filesystem server will be available in the integrations
Security Note
Only directories specified in the args array will be accessible. The server enforces strict path validation to prevent access outside allowed directories.
Troubleshooting
-
Command not found:
- Make sure the package is installed (
uv pip list) - Check your Python environment is activated
- Make sure the package is installed (
-
Access denied:
- Verify the directories in
argsexist - Ensure you have read permissions for specified directories
- Verify the directories in
-
Server not showing in Claude Desktop:
- Check your config file syntax
- Restart Claude Desktop after config changes
Recommended Servers
Excel MCP Server
A Model Context Protocol server that enables AI assistants to read from and write to Microsoft Excel files, supporting formats like xlsx, xlsm, xltx, and xltm.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
Crawlab MCP Server
MCP File Context Server
A Model Context Protocol server that enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.
MCP Tools for Obsidian
A local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.
MCP File Preview Server
Provides HTML file preview and analysis capabilities. This server enables capturing full-page screenshots of local HTML files and analyzing their structure.
Cline Personas MCP Server
An MCP server for managing and activating persona templates and components by writing to .clinerules files, supporting version tracking and file-based storage.
Filesystem MCP Server
MCP Tasks Organizer
An MCP server that converts Cursor agent plans into structured markdown task lists and organizes them in your repository, helping you track AI-generated plans and recommendations as actionable specifications.
Obsidian MCP REST Server
Provides a standardized interface for AI assistants to interact with Obsidian vaults through a local REST API, enabling reading, writing, searching, and managing notes.