The Complete Production SOP: How to Deploy and Run FastMCP Python Server Architecture in Autonomous AI Agents

---
name: "mcp-server-python-fastmcp"
description: "Build high-performance MCP servers in Python using FastMCP decorator syntax."
metadata:
  author: "jlowin"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "create fastmcp server python"
  - "decorate tool fastmcp"
  - "add mcp resource fastmcp"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# FastMCP Python Server Architecture
Develops Model Context Protocol servers using FastMCP: @mcp.tool() decorators, @mcp.resource() URI providers, @mcp.prompt() templates, and automated type inference.

from mcp.server.fastmcp import FastMCP, Context
from pydantic import Field
import os

mcp = FastMCP("WorkspaceAnalyzer", dependencies=["pydantic"])

@mcp.tool()
def inspect_directory(path: str = Field(description="Workspace sub-path to inspect")) -> list[str]:
    """Enumerate contents of workspace path safely."""
    target = os.path.abspath(path)
    if not target.startswith(os.getcwd()):
        raise ValueError("Path access out of bounds")
    return os.listdir(target)

if __name__ == "__main__":
    mcp.run(transport="stdio")

from mcp.server.fastmcp import FastMCP
import sqlite3

mcp = FastMCP("SQLiteMCP")
DB_PATH = "workspace.db"

@mcp.resource("schema://main")
def get_schema() -> str:
    """Provide SQLite table schemas to client context."""
    with sqlite3.connect(DB_PATH) as conn:
        cursor = conn.cursor()
        cursor.execute("SELECT sql FROM sqlite_master WHERE type='table';")
        return "\n".join(row[0] for row in cursor.fetchall() if row[0])

@mcp.tool()
def query_database(sql: str) -> list[dict]:
    """Execute read-only SQL queries on workspace database."""
    if not sql.strip().upper().startswith("SELECT"):
        raise ValueError("Only read-only SELECT operations permitted")
    with sqlite3.connect(DB_PATH) as conn:
        conn.row_factory = sqlite3.Row
        cursor = conn.cursor()
        cursor.execute(sql)
        return [dict(row) for row in cursor.fetchall()]

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