# MCP File System Server

A Model Context Protocol (MCP) server that provides secure file system operations through a sandboxed environment.

## Features

- **Secure File Operations**: All operations are confined to a configurable base directory
- **Path Traversal Protection**: Prevents access to files outside the allowed directory
- **Comprehensive Tools**: Read, write, list, delete, move, and copy files
- **Error Handling**: Robust error handling with informative messages

## Installation

1. Install dependencies:
```bash
make install
```

2. Set the base directory (optional):
```bash
export MCP_FILE_SYSTEM_BASE_DIR="/path/to/your/sandbox"
```

## Usage

### Running the Server

```bash
make run
```

Or directly:
```bash
uv run src/main.py
```

### Available Tools

- `read_file(file_path: str)` - Read file contents
- `write_file(file_path: str, content: str)` - Write content to file
- `list_directory(directory_path: str)` - List directory contents
- `delete_file(file_path: str)` - Delete a file
- `move_file(source_path: str, destination_path: str)` - Move/rename a file
- `copy_file(source_path: str, destination_path: str)` - Copy a file

## Configuration

The server uses the `MCP_FILE_SYSTEM_BASE_DIR` environment variable to set the base directory for all file operations. If not set, it defaults to `/tmp/mcp_file_system`.

## Security

- All paths are resolved relative to the base directory
- Path traversal attacks (using `..`) are prevented
- Access outside the base directory is blocked
- File operations are sandboxed

## Testing

Test that the server imports correctly:
```bash
make test
```

## Development

Run in development mode with auto-reload:
```bash
make dev
```

## Integration with Claude Desktop

To use this server with Claude Desktop, add the following to your `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "file-system": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp_file_system",
        "run",
        "src/main.py"
      ]
    }
  }
}
```

Replace `/ABSOLUTE/PATH/TO/mcp_file_system` with the actual absolute path to your project directory.