Claude MarketplacesSubmit
smithery-ai avatar

Smithery Ai Cookbook Python Quickstart

smithery-ai/smithery-cookbook

This is the hello world example from Smithery's official cookbook, built with FastMCP in Python. It exposes a single greeting tool to demonstrate the basics of creating an MCP server. You'd use this as a starting point to understand the FastMCP framework structure before building something real. The source repo includes migration guides for moving from stdio to HTTP transport and examples of session configuration. If you're learning to build MCP servers in Python or want a minimal reference implementation to copy from, this is the canonical first step. The actual server does nothing useful beyond proving your setup works.

auth
Secret needed
transport
HTTP
last updated
Sep 10, 2025
View on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

Smithery Cookbook

The Smithery Cookbook provides code examples and guides designed to help developers build MCP (Model Context Protocol) servers and clients, offering copy-able code snippets that you can easily integrate into your own projects.

Prerequisites

To make the most of the examples in this cookbook, you'll need:

  • Smithery CLI: Install with npm install -g @smithery/cli to access the interactive playground and development tools
  • Programming language runtimes for the examples you want to explore (Python 3.12+, Node.js 18+, etc.)
  • Basic understanding of the Model Context Protocol (MCP)

Quick Start

  1. Clone this repository:

    git clone https://github.com/smithery-ai/smithery-cookbook.git
cd smithery-cookbook

  2. Choose an example and follow its README:

    cd servers/python/quickstart
# Follow the README.md instructions

  3. Test with Smithery Playground:

    npx @smithery/cli playground --port 8081

    Note: Replace 8081 with the port your server is running on

View the full README on GitHub

Details

Repository
github.com/smithery-ai/smithery-cookbook
Transport
HTTP
Auth
Required
Registry
MCP registry, active