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

4. 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:

1. Build your MCP server using the language and framework of your choice
2. Test interactively with npx @smithery/cli playground
3. Debug with real-time request/response inspection
4. Deploy to Smithery's hosted platform - Deploy here
5. 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