# MCP Filesystem Python

A Model Context Protocol (MCP) server that provides secure, read-only access to files in a specified directory.

## Features

- Exposes files as MCP resources using \`file://\` URI scheme
- Provides file search capabilities through MCP tools
- Respects .gitignore patterns
- Security features including path traversal protection
- MIME type detection

## Installation

Using UV:

```bash
uv add mcp-filesystem-python
```

## Usage

Run the server:

```bash
uv run src/filesystem/server.py /path/to/directory
```

## Claude Desktop Integration

### Configuration Examples

Example configurations for Claude Desktop can be found in the \`examples\` directory:

- \`examples/claude_desktop_config.json\`: Example for macOS/Linux
- \`examples/claude_desktop_config_windows.json\`: Example for Windows

These files should be placed at:
- macOS: \`~/Library/Application Support/Claude/claude_desktop_config.json\`
- Windows: \`%AppData%\\Claude\\claude_desktop_config.json\`

Make sure to:
1. Replace the paths with your actual paths
2. Use forward slashes (\`/\`) for macOS/Linux and backslashes (\`\\\\\`) for Windows
3. Use absolute paths (not relative paths)

## Development

1. Clone the repository
2. Create virtual environment and sync requirements, ```uv sync```

## License

[MIT](LICENSE)