fastmcp-cloud-deployment

# FastMCP Cloud Deployment Skill

This skill provides comprehensive deployment lifecycle management for FastMCP servers, including pre-deployment validation, local testing, post-deployment verification, environment variable checking, and deployment tracking.

## Overview

The deployment lifecycle consists of five phases:
1. **Pre-Deployment Validation** - Syntax, dependencies, configuration
2. **Local Testing** - STDIO and HTTP transport testing
3. **Environment Verification** - Environment variable validation
4. **Deployment** - To FastMCP Cloud, HTTP, or STDIO
5. **Post-Deployment Verification** - Health checks, endpoint testing

## Available Scripts

### 1. Pre-Deployment Validation

**Script**: `scripts/validate-server.sh <server-path>`

**Purpose**: Validates server is ready for deployment

**Checks**:
- Server file exists (server.py, server.ts, index.ts)
- Syntax validation (Python/TypeScript)
- Dependencies declared (requirements.txt or package.json)
- FastMCP dependency included
- fastmcp.json configuration valid
- No hardcoded secrets
- Environment configuration present
- .gitignore properly configured

**Usage**:
```bash
# Validate current directory
./scripts/validate-server.sh .

# Validate specific server
./scripts/validate-server.sh /path/to/server

# Verbose mode
VERBOSE=1 ./scripts/validate-server.sh .
```

**Exit Codes**:
- `0`: Validation passed (may have warnings)
- `1`: Validation failed (must fix before deployment)

**Example Output**:
```
=== FastMCP Server Pre-Deployment Validation ===
✓ Found Python server file: server.py
✓ Python syntax is valid
✓ FastMCP dependency declared in requirements.txt
✓ fastmcp.json has valid JSON syntax
✓ Server name: my-server
⚠ Found 2 unpinned dependencies
✓ No obvious hardcoded secrets detected

Results: 12 passed, 0 failed, 1 warnings
✓ Server passed validation - ready for deployment
```

### 2. Local Testing

**Script**: `scripts/test-local.sh <server-path>`

**Purpose**: Tests server locally before deploymen