39 lines
995 B
Markdown
39 lines
995 B
Markdown
# 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.
|