vivekprajapat305/Claude-mcp-server

File Manager MCP Server 📁

A simple and beginner-friendly MCP (Model Context Protocol) server that helps Claude interact with your files and directories.

🌟 Features

This MCP server allows Claude to:

• 📋 List files and folders in directories
• 📄 Read file contents
• ℹ️ Get detailed file information (size, modification date, etc.)
• 🔍 Search for files by name patterns
• 🗂️ Navigate through your file system

🚀 Quick Setup

Step 1: Install Python

Make sure you have Python 3.7+ installed on your computer.

Step 2: Download Files

Download these files to a folder on your computer:

• server.py (the main server code)
• requirements.txt (list of required packages)
• README.md (this file)

Step 3: Install Dependencies

Open terminal/command prompt in the folder and run:

pip install -r requirements.txt

Step 4: Test the Server

Run the server to make sure it works:

python server.py

🔧 Claude Desktop Configuration

To connect this MCP server to Claude Desktop, add this configuration:

For Windows:

Add to your Claude Desktop config file (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "file-manager": {
      "command": "python",
      "args": ["C:\\path\\to\\your\\server.py"],
      "env": {}
    }
  }
}

For Mac:

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "file-manager": {
      "command": "python3",
      "args": ["/path/to/your/server.py"],
      "env": {}
    }
  }
}

Important: Replace /path/to/your/server.py with the actual full path to your server.py file!

📝 How to Use

Once connected, you can ask Claude things like:

• "List all files in my Documents folder"
• "What's in the file called 'notes.txt'?"
• "Find all Python files in my project folder"
• "Show me information about this file"
• "Search for files that start with 'report'"

📂 Default Directory

By default, the server works with your Documents folder. You can change this by editing the DEFAULT_DIRECTORY variable in server.py:

# Change this line to your preferred directory
DEFAULT_DIRECTORY = os.path.expanduser("~/Documents")

For example:

• "~/Desktop" for Desktop
• "~/Downloads" for Downloads
• "/Users/yourname/Projects" for a custom folder

🛠️ Customization

Want to add more features? You can modify server.py to:

• Add file writing capabilities
• Include file deletion/creation
• Add support for different file types
• Create file backup functions

❗ Troubleshooting

Common Issues:

1. "Command not found" error:

• Make sure Python is installed and in your PATH
• Try using python3 instead of python

2. "Module not found" error:

• Run pip install -r requirements.txt again
• Make sure you're in the correct directory

3. "Permission denied" error:

• Check that Claude Desktop has permission to access your files
• Make sure the file paths in your config are correct

4. Server not connecting:

• Verify the path in your Claude Desktop config is correct
• Restart Claude Desktop after making config changes
• Check that the server runs successfully when tested manually

Getting Help:

If you encounter issues:

1. Make sure all file paths are correct
2. Test the server manually first
3. Check Claude Desktop's error logs
4. Verify your config JSON syntax is valid

🔒 Security Note

This server only reads files and lists directories. It cannot:

• Delete files
• Modify files
• Create new files
• Access system files outside the specified directory

This makes it safe for beginners to use!

📚 Learn More

• MCP Official Documentation
• Claude Desktop Setup Guide
• Python Pathlib Documentation

Happy file managing with Claude! 🎉