MCP Filesystem Server
About
This server enables Claude Desktop to interact with files in user‑specified directories. It is an unofficial Proof‑of‑Concept port of Claude’s filesystem MCP server, created for educational purposes and not intended for production.
Explore
- Enforces strict path validation for security
- Only directories in args are accessible
- Supports multiple directory specifications
- Unofficial Proof‑of‑Concept implementation
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Filesystem ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Install using UVX:
uv venv
.venv\Scripts\activate # On Windows
uv pip install -e .
1. 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"
]
}
}
}
2. Restart Claude Desktop to apply changes
3. In Claude Desktop:
- Click the paperclip icon
- Select the MCP menu (two electrical plugs connecting)
- Your filesystem server will be available in the integrations
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp filesystem server": {
"philgei_mcp_server_filesystem": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"philgei_mcp_server_filesystem": {
"command": "uv",
"args": [
"venv"
]
}
}> 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
1. Install using UVX:
uv venv
.venv\Scripts\activate # On Windows
uv pip install -e .
Usage with Claude Desktop
1. 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"
]
}
}
}
2. Restart Claude Desktop to apply changes
3. 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 theargs array will be accessible. The server enforces strict path validation to prevent access outside allowed directories.
Troubleshooting
1. Command not found:
- Make sure the package is installed (uv pip list)
- Check your Python environment is activated
2. Access denied:
- Verify the directories in args exist
- Ensure you have read permissions for specified directories
3. Server not showing in Claude Desktop:
- Check your config file syntax
- Restart Claude Desktop after config changes
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
