Example prompts for Smithery AI Cookbook Python Quickstart

Paste any of these into Agent Studio after connecting Smithery AI Cookbook Python Quickstart.

Show me how to create a basic FastMCP server with a greeting tool

How do I migrate an MCP server from STDIO to HTTP transport

Build a simple TypeScript MCP server that counts characters

What's the fastest way to test my MCP server locally with Smithery

Excerpted from the project's README — boilerplate sections (license, changelog, contributing) omitted for clarity.

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

Clone this repository:

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

Choose an example and follow its README:

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

Test with Smithery Playground:
```
npx @smithery/cli playground --port 8081
```
Note: Replace 8081 with the port your server is running on
Deploy to Smithery (optional): Ready to share your MCP server? Deploy it here to host it on Smithery's platform.

Table of Recipes

Python Servers

FastMCP Quickstart - Basic server with greeting tool
FastMCP Advanced - Server with session configuration
Migrate STDIO to HTTP - Server with custom Docker container

TypeScript Servers

TypeScript Quickstart - Simple server with character counting tool
TypeScript Session Config - Server with session configuration
Migrate STDIO to HTTP - Smithery CLI - Server using Smithery CLI
Migrate STDIO to HTTP - Custom Container - Server with custom Docker container

Development Workflow

Build and distribute your MCP servers with Smithery:

Build your MCP server using the language and framework of your choice
Test interactively with npx @smithery/cli playground
Debug with real-time request/response inspection
Deploy to Smithery's hosted platform - Deploy here
Distribute your server gets its own page at smithery.ai/server/{name} for others to discover and use

Explore Further

Looking for more resources to enhance your MCP development experience?

Smithery Documentation - Complete guides and API reference
Deploy Your MCP Server - Host your server on Smithery's platform
Model Context Protocol Specification - Official MCP documentation
Smithery Discord Community - Get help and share your projects

If you have ideas for new examples or guides, share them on the issues page.

Smithery AI Cookbook Python Quickstart MCP server — FAQ

Common questions about connecting and running Smithery AI Cookbook Python Quickstart.

What is the Smithery Cookbook and who should use it?

The Smithery Cookbook is a collection of code examples and guides for building MCP servers and clients in Python and TypeScript. It's designed for developers learning the Model Context Protocol who want ready-to-use code snippets they can integrate into their projects.

What are the prerequisites to use these examples?

You need the Smithery CLI (installed via `npm install -g @smithery/cli`), a programming language runtime (Python 3.12+ or Node.js 18+), and basic familiarity with the Model Context Protocol. The README does not specify other dependencies per example.

How do I test an MCP server from the cookbook locally?

Clone the repository, navigate to your chosen example directory, and run `npx @smithery/cli playground --port 8081` (replacing 8081 with your server's port). This opens an interactive playground for testing your server.

Can I deploy these example servers to production?

Yes, the cookbook includes optional deployment to Smithery's hosted platform. After testing locally, you can deploy at smithery.ai/new to host your server and get a public page at smithery.ai/server/{name} for others to discover.

What languages and frameworks does the cookbook cover?

The cookbook provides examples in Python (using FastMCP) and TypeScript, with recipes ranging from basic quickstarts to advanced session configuration and Docker container migration. Both languages include STDIO-to-HTTP migration guides.

Smithery AI Cookbook Python Quickstart MCP Server

Smithery AI Cookbook Python Quickstart repository at a glance

What the Smithery AI Cookbook Python Quickstart MCP server does

Connect to Smithery AI Cookbook Python Quickstart

Resources