# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# Clone or navigate to the project directory
cd file-server-mcp

# Install dependencies
uv sync

# Optional: Install development dependencies
uv sync --extra dev

FILE_SERVER_FILE_STORAGE_DIR=./file_storage
FILE_SERVER_MAX_UPLOAD_SIZE=104857600  # 100MB
FILE_SERVER_CHUNK_SIZE=1048576         # 1MB

# Run with UV
uv run python -m file_server_mcp

# Or with uvicorn directly
uv run uvicorn file_server_mcp.server:app --host 0.0.0.0 --port 8000 --reload

# List all files
curl http://localhost:8000/api/files

# Get file info
curl http://localhost:8000/api/files/example.txt

# Download file
curl http://localhost:8000/api/files/example.txt/download -o downloaded.txt

# Delete file
curl -X DELETE http://localhost:8000/api/files/example.txt

# Health check
curl http://localhost:8000/health

# View OpenAPI docs
# Open http://localhost:8000/docs in your browser

{
  "mcpServers": {
    "file-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/file-server-mcp",
        "run",
        "python",
        "-m",
        "file_server_mcp"
      ],
      "env": {
        "FILE_SERVER_FILE_STORAGE_DIR": "/path/to/storage"
      }
    }
  }
}

# Install MCP Inspector
npm install -g @modelcontextprotocol/inspector

# Run the server with inspector
mcp-inspector uv --directory /path/to/file-server-mcp run python -m file_server_mcp

"List all files in the file server"
"Get information about report.pdf"
"Create a new file called notes.txt with content 'Hello World'"
"Get a download link for large-video.mp4"
"Delete old-file.txt"
"Replace the content of config.json"

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=file_server_mcp --cov-report=html

# Run specific test file
uv run pytest tests/test_storage.py

# Run with verbose output
uv run pytest -v

file-server-mcp/
├── .python-version          # Python version
├── pyproject.toml           # UV configuration and dependencies
├── uv.lock                  # Auto-generated lockfile
├── .env.example             # Environment variable template
├── README.md                # This file
├── src/
│   └── file_server_mcp/
│       ├── __init__.py      # Package initialization
│       ├── __main__.py      # Entry point
│       ├── config.py        # Environment configuration
│       ├── models.py        # Pydantic schemas
│       ├── storage.py       # File operations
│       ├── rest_routes.py   # FastAPI REST endpoints
│       ├── mcp_tools.py     # MCP tool definitions
│       └── server.py        # Main hybrid server
└── tests/
    ├── __init__.py
    ├── conftest.py          # Pytest fixtures
    ├── test_storage.py      # Storage layer tests
    ├── test_rest_routes.py  # REST API tests
    └── test_mcp_tools.py    # MCP tools tests

# For small files (< 100MB), use MCP tool directly
create_file_tool(filename="small.pdf", content=base64_content, encoding="base64")

# For large files, use download link
link = get_file_download_link_tool(filename="large.pdf")
# Returns: {"filename": "large.pdf", "download_url": "/api/files/large.pdf/download"}
# Fetch via REST API using the download_url

# Input: "../../etc/passwd"
# Sanitized to: "passwd"
# Saved in: <storage_dir>/passwd

# Check Python version
python --version  # Should be 3.11+

# Reinstall dependencies
uv sync --reinstall

# Check storage directory permissions
ls -la ./file_storage

# Clear pytest cache
rm -rf .pytest_cache

# Run tests with verbose output
uv run pytest -vv

# Run a single test
uv run pytest tests/test_storage.py::test_sanitize_filename -v