# mcp.txt

A minimal MCP server for managing text files from Claude (web, desktop, and iOS).

## Setup

```bash
bun install
```

## Usage

```bash
DATA_DIR=~/Documents/claude-files PORT=3100 bun start
```

- `DATA_DIR` — directory the server reads/writes from (default: `~/Documents/claude-files`)
- `PORT` — HTTP port (default: `3001`)

## Tools

| Tool | Description |
|------|-------------|
| `list_files` | List files and directories in a given path |
| `read_file` | Read the contents of a text file |
| `create_file` | Create a new file (fails if it already exists) |
| `edit_file` | Replace the contents of an existing file |

All paths are relative to `DATA_DIR`. Path traversal is rejected. There is no delete — by design.

## Connect to Claude

1. Run the server
2. Expose via HTTPS tunnel (e.g. Sneakers, ngrok, Cloudflare Tunnel)
3. Claude.ai → Settings → Integrations → Add Custom Integration
4. Set the URL to `https://your-tunnel/mcp`

Works on web, desktop, and iOS.