MCP Notes

from datetime import datetime, timezone
import html

from fastmcp import FastMCP  # Assuming `fastmcp` is a third-party package

# Create an MCP server instance
# The "XS Demo MCP Server" name is used for identification in clients
mcp = FastMCP("XS Demo MCP Server", json_response=True)

# Add a UTC Time tool using the @mcp.tool() decorator
@mcp.tool()
def get_current_utc_time() -> str:
    """
    Returns the current UTC Time
    """
    return f"Current UTC Time: {datetime.now(timezone.utc).isoformat()}"

# Add an addition tool using the @mcp.tool() decorator
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers and return the result."""
    return a + b

# Add a subtraction tool using the @mcp.tool() decorator
@mcp.tool()
def subtract(a: int, b: int) -> int:
    """Subtract two numbers and return the result."""
    return a - b

# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting with sanitized input."""
    # Sanitize the name by escaping HTML special characters
    sanitized_name = html.escape(name)
    return f"Hello, [{sanitized_name}]!"

if __name__ == "__main__":
    # Run the server using the streamable HTTP transport
    print("Running MCP server on http://127.0.0.1:8000")
    mcp.run(transport="streamable-http", port=8000)

Running MCP server on http://127.0.0.1:8000


                                                                                     ╭──────────────────────────────────────────────────────────────────────────────╮
                                                                                     │                                                                              │
                                                                                     │                         ▄▀▀ ▄▀█ █▀▀ ▀█▀ █▀▄▀█ █▀▀ █▀█                        │
                                                                                     │                         █▀  █▀█ ▄▄█  █  █ ▀ █ █▄▄ █▀▀                        │
                                                                                     │                                                                              │
                                                                                     │                                FastMCP 2.14.1                                │
                                                                                     │                                                                              │
                                                                                     │                                                                              │
                                                                                     │                  🖥  Server name: XS Demo MCP Server                          │
                                                                                     │                                                                              │
                                                                                     │                  📦 Transport:   HTTP                                        │
                                                                                     │                  🔗 Server URL:  http://127.0.0.1:8000/mcp                   │
                                                                                     │                                                                              │
                                                                                     │                  📚 Docs:        https://gofastmcp.com                       │
                                                                                     │                  🚀 Hosting:     https://fastmcp.cloud                       │
                                                                                     │                                                                              │
                                                                                     ╰──────────────────────────────────────────────────────────────────────────────╯


[12/26/25 17:40:48] INFO     Starting MCP server 'XS Demo MCP Server' with transport 'streamable-http' on http://127.0.0.1:8000/mcp                                                                                                         server.py:2618
INFO:     Started server process [15528]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)