MCP File Operations Server

A Model Context Protocol (MCP) server that provides file operation tools for Claude Desktop.

Features

• read_file: Read file contents
• write_file: Write content to files
• list_directory: List directory contents
• create_directory: Create directories
• delete_file: Delete files
• delete_directory: Delete directories
• copy_file: Copy files
• move_file: Move/rename files
• get_file_info: Get file metadata

Installation

Quick Installation

Run the installation script:

bash scripts/install.sh

Manual Installation

1. Create virtual environment:

   python3 -m venv .venv
   source .venv/bin/activate
   

2. Install the package:

   pip install -e .
   

3. Install development dependencies (optional):

   pip install -e ".[dev]"
   

Testing

Run the test suite:

python -m pytest tests/

Or run tests directly:

python tests/test_file_operations.py

Claude Desktop Integration

1. Find your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

   {
     "mcpServers": {
       "file-operations": {
         "command": "/bin/bash",
         "args": ["/path/to/your/mcp/scripts/run_server.sh"]
       }
     }
   }
   

   Note: Update the path in args to match your actual installation directory.

3. Restart Claude Desktop to load the new server.

Usage

Once integrated, you can use commands like:

• "Read the file at /path/to/file.txt"
• "Write 'Hello World' to /path/to/output.txt"
• "List the contents of /path/to/directory"
• "Create a directory at /path/to/new/dir"
• "Delete the file /path/to/unwanted.txt"
• "Copy file from /source to /destination"

Security Notes

• The server has full file system access
• Only use with trusted content
• Consider restricting paths in production environments

Testing

Run the test suite:

python test_server.py

LangGraph Integration

This package includes a complete LangGraph integration that allows you to use MCP file operations as tools within LangGraph workflows.

Installation with LangGraph

# Install with LangGraph support
pip install -e ".[langgraph]"

Quick Start

import asyncio
from mcp_file_operations.integrations.langgraph_client import create_mcp_file_tools

async def example():
    # Create MCP file operation tools for LangGraph
    file_tools = create_mcp_file_tools()
    
    # Use tools in your LangGraph workflow
    write_tool = next(tool for tool in file_tools if tool.name == "write_file")
    result = await write_tool._arun(path="/tmp/test.txt", content="Hello LangGraph!")
    print(result)

asyncio.run(example())

Examples

• Simple Integration: examples/simple_langgraph_example.py
• Full Workflow: examples/langgraph_file_workflow.py
• Documentation: docs/LANGGRAPH_INTEGRATION.md

Available LangGraph Tools

All MCP file operations are available as LangGraph tools:

• read_file, write_file, list_directory, create_directory
• delete_file, delete_directory, copy_file, move_file, get_file_info

License

MIT License