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

Create virtual environment:
python3 -m venv .venv source .venv/bin/activate
Install the package:
pip install -e .
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

Find your Claude Desktop config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
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.
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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

A Model Context Protocol server that enables Claude Desktop to perform file operations like reading, writing, listing directories, and managing files through natural language commands.

Related MCP Servers

MCP Memory Server
ebailey78
-
security
F
license
-
quality
A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
Last updated -
TypeScript
Claude TypeScript MCP Servers
ukkz
A
security
A
license
A
quality
A collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.
Last updated -
2
19
TypeScript
MIT License
MCP Tools
ZbigniewTomanek
-
security
A
license
-
quality
A custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.
Last updated -
22
Python
Apache 2.0
Notion MCP Server
tkc
-
security
F
license
-
quality
A filesystem Model Context Protocol server that provides Claude Desktop with capabilities to read, write, and manipulate files on your system.
Last updated -
TypeScript

View all related MCP servers

MCP File Operations Server