Summary
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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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/clito 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 8081Note: Replace
8081with 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.
License
MIT License
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →