Skip to main content
This guide shows you how to run a Snow Leopard MCP server using FastMCP and connect it to an MCP client.

Prerequisites

Don’t have data? Use our sample superheroes dataset to get started, or choose from our other sample datasets.

Run the Snow Leopard MCP server

Clone the example server:
git clone https://github.com/SnowLeopard-AI/snowy-examples.git
cd snowy-examples/quickstart/fastmcp
Set your environment variables:
export SNOWLEOPARD_API_KEY=your-snowleopard-key
export SNOWLEOPARD_DATAFILE_ID=your-datafile-id
Run the server:
uv run fastmcp run server.py

Customize the tool description (optional)

The tool’s docstring tells agents when and how to use it. Edit server.py to describe your specific data:
@mcp.tool
def get_data(user_query: str):
    """
    Retrieve customer order data.
    Contains order history, products, and customer information.
    Use this to answer questions about sales, orders, and customers.
    """
    return snowy.retrieve(user_query=user_query, datafile_id=datafile_id)

Connect to the MCP server

You can now connect the server to any application that supports MCP. Below we show how to connect with Claude Desktop.

Claude Desktop

Add the server to your Claude Desktop configuration (claude_desktop_config.json):
{
  "mcpServers": {
    "snowy": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/snowy-examples/quickstart/fastmcp",
        "run",
        "fastmcp",
        "run",
        "server.py"
      ],
      "env": {
        "SNOWLEOPARD_API_KEY": "your-api-key",
        "SNOWLEOPARD_DATAFILE_ID": "your-datafile-id"
      }
    }
  }
}
Now you can ask Claude questions about your data.

Next steps