Fastmcp

---
=== BEGIN ORIGINAL SKILL.md (preserve this content) ===
---
name: fastmcp
description: |
  Build MCP servers in Python with FastMCP framework to expose tools, resources, and prompts to LLMs. Supports
  storage backends (memory/disk/Redis), middleware, OAuth Proxy, OpenAPI integration, and FastMCP Cloud deployment.

  Use when: creating MCP servers, defining tools or resources, implementing OAuth authentication, configuring
  storage backends for tokens/cache, adding middleware for logging/rate limiting, deploying to FastMCP Cloud,
  or troubleshooting module-level server, storage, lifespan, middleware order, circular imports, or OAuth errors.

  Keywords: FastMCP, MCP server Python, Model Context Protocol Python, fastmcp framework, mcp tools, mcp resources, mcp prompts, fastmcp storage, fastmcp memory storage, fastmcp disk storage, fastmcp redis, fastmcp dynamodb, fastmcp lifespan, fastmcp middleware, fastmcp oauth proxy, server composition mcp, fastmcp import, fastmcp mount, fastmcp cloud, fastmcp deployment, mcp authentication, fastmcp icons, openapi mcp, claude mcp server, fastmcp testing, storage misconfiguration, lifespan issues, middleware order, circular imports, module-level server, async await mcp
license: MIT
metadata:
  version: "2.0.0"
  package_version: "fastmcp>=2.13.0"
  python_version: ">=3.10"
  token_savings: "90-95%"
  errors_prevented: 25
  production_tested: true
  last_updated: "2025-11-04"
---

# FastMCP - Build MCP Servers in Python

FastMCP is a Python framework for building Model Context Protocol (MCP) servers that expose tools, resources, and prompts to Large Language Models like Claude. This skill provides production-tested patterns, error prevention, and deployment strategies for building robust MCP servers.

## Quick Start

### Installation

```bash
pip install fastmcp
# or
uv pip install fastmcp
```

### Minimal Server

```python
from fastmcp import FastMCP

# MUST be at module level for FastMCP Cloud
mcp = FastMCP("My Server")

@mcp.tool()
async def hello(name: str) -> str:
    """Say hello to someone."""
    return f"Hello, {name}!"

if __name__ == "__main__":
    mcp.run()
```

**Run it:**
```bash
# Local development
python server.py

# With FastMCP CLI
fastmcp dev server.py

# HTTP mode
python server.py --transport http --port 8000
```

### System Checks

Run the system permission checker to ensure proper setup:

```bash
python scripts/system_perms_checker.py
```

=== END ORIGINAL SKILL.md ===

---
scripts/check-versions.sh ---
#!/bin/bash
# FastMCP Version Checker
# Verifies that FastMCP and dependencies are up to date

set -e

echo "======================================"
echo "FastMCP Version Checker"
echo "======================================"
echo ""

# Colors
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
NC='\033[0m' # No Color

# Check if Python is installed
if ! command -v python3 &> /dev/null; then
    echo -e "${RED}✗${NC} Python 3 is not installed"
    exit 1
fi

echo -e "${GREEN}✓${NC} Python $(python3 --version)"
echo ""

# Check Python version
PYTHON_VERSION=$(python3 -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')
REQUIRED_VERSION="3.10"

if [ "$(printf '%s\n' "$REQUIRED_VERSION" "$PYTHON_VERSION" | sort -V | head -n1)" != "$REQUIRED_VERSION" ]; then
    echo -e "${RED}✗${NC} Python $PYTHON_VERSION is too old. FastMCP requires Python $REQUIRED_VERSION or later"
    exit 1
fi

echo -e "${GREEN}✓${NC} Python version $PYTHON_VERSION meets requirements"
echo ""

# Check if pip is installed
if ! command -v pip3 &> /dev/null; then
    echo -e "${RED}✗${NC} pip3 is not installed"
    exit 1
fi

echo "Checking package versions..."
echo ""

# Function to check package version
check_package() {
    local package=$1
    local min_version=$2

    if pip3 show "$package" &> /dev/null; then
        local installed_version=$(pip3 show "$package" | grep "Version:" | awk '{print $2}')
        echo -e "${GREEN}✓${NC} $package: $installed_version (required: >=$m
---
scripts/deploy-cloud.sh ---
#!/bin/bash
# FastMCP Cloud Deployment Checker
# Validates server is ready for FastMCP Cloud deployment

set -e

# Colors
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

echo "======================================"
echo "FastMCP Cloud Deployment Checker"
echo "======================================"
echo ""

# Check arguments
if [ $# -eq 0 ]; then
    echo "Usage: $0 <server.py>"
    echo ""
    echo "Example:"
    echo "  $0 server.py"
    exit 1
fi

SERVER_PATH=$1
ERRORS=0
WARNINGS=0

# Function to check requirement
check_required() {
    local description=$1
    local command=$2

    if eval "$command" &> /dev/null; then
        echo -e "${GREEN}✓${NC} $description"
        return 0
    else
        echo -e "${RED}✗${NC} $description"
        ERRORS=$((ERRORS + 1))
        return 1
    fi
}

# Function to check warning
check_warning() {
    local description=$1
    local command=$2

    if eval "$command" &> /dev/null; then
        echo -e "${GREEN}✓${NC} $description"
        return 0
    else
        echo -e "${YELLOW}⚠${NC} $description"
        WARNINGS=$((WARNINGS + 1))
        return 1
    fi
}

# 1. Check server file exists
echo "Checking server file..."
check_required "Server file exists: $SERVER_PATH" "test -f '$SERVER_PATH'"
echo ""

# 2. Check Python syntax
echo "Checking Python syntax..."
check_required "Python syntax is valid" "python3 -m py_compile '$SERVER_PATH'"
echo ""

# 3. Check for module-level server