MIT-AI-studio-HW3: Instructions file for Codex

AGENTS.md

Welcome to the Smithery Python MCP Server Scaffold!

This is the template project that gets cloned when you run uvx smithery init. It provides everything you need to build, test, and deploy a Model Context Protocol (MCP) server with Smithery.

What's Included

• FastMCP Server with Smithery session-scoped configuration support
• Example Tool (hello tool with pirate mode configuration)
• Example Resource (history://hello-world with Hello World origin story)
• Example Prompt (greet prompt for generating greeting messages)
• Development Workflow (uv run dev for local testing, uv run playground for interactive testing)
• Deployment Ready configuration for the Smithery platform
• Session Management via @smithery.server() decorator with optional config schemas

Quick Start Commands

# Run development server (streamable HTTP on port 8081)
uv run dev

# Run production server (optimized for deployment)
uv run start

# Test with interactive playground
uv run playground

Development Workflow

Based on the Model Context Protocol architecture, MCP servers provide three core primitives:

1. Tools (for actions)

Add executable functions that AI applications can invoke to perform actions:

@server.tool()
def hello(name: str, ctx: Context) -> str:
    """Say hello to someone."""
    session_config = ctx.session_config
    if session_config.pirate_mode:
        return f"Ahoy, {name}!"
    else:
        return f"Hello, {name}!"

2. Resources (for static data)

Add data sources that provide contextual information:

@server.resource("history://hello-world")
def hello_world() -> str:
    """The origin story of the famous 'Hello, World' program."""
    return (
        '"Hello, World" first appeared in a 1972 Bell Labs memo by '
        "Brian Kernighan and later became the iconic first program "
        "for beginners in countless languages."
    )