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

1. Choose an example and follow its README:

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

1. Test with Smithery Playground:

   npx @smithery/cli playground --port 8081

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

1. 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](servers/python/quickstart/) - Basic server with greeting tool
• [FastMCP Advanced](servers/python/server_with_session_config/) - Server with session configuration
• [Migrate STDIO to HTTP](servers/python/migrate_stdio_to_http/) - Server with custom Docker container

TypeScript Servers

• [TypeScript Quickstart](servers/typescript/quickstart/) - Simple server with character counting tool
• [TypeScript Session Config](servers/typescript/server_with_session_config/) - Server with session configuration
• [Migrate STDIO to HTTP - Smithery CLI](servers/typescript/migrate_stdio_to_http/server_with_smithery_cli/) - Server using Smithery CLI
• [Migrate STDIO to HTTP - Custom Container](servers/typescript/migrate_stdio_to_http/server_with_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