ai.smithery/smithery-ai-cookbook-ts-smithery-cli MCP Server
ai.smithery/smithery-ai-cookbook-ts-smithery-cli
Educational examples and code snippets for building MCP servers with TypeScript and the Smithery CLI.
What is the ai.smithery/smithery-ai-cookbook-ts-smithery-cli MCP server?
The Smithery Cookbook is a collection of code examples and guides for developers building MCP (Model Context Protocol) servers and clients. It provides copy-able TypeScript and Python server examples that demonstrate core MCP concepts, from basic quickstart projects to advanced session configuration and HTTP migration patterns.
This is a learning resource and template repository rather than a functional MCP server itself. It contains multiple example MCP server implementations in TypeScript and Python that you can clone, study, and adapt for your own projects. Use it to understand MCP architecture, see best practices, and accelerate your server development.
How to install ai.smithery/smithery-ai-cookbook-ts-smithery-cli
Copy-paste configuration for popular MCP clients.
AuthorizationrequiredsecretBearer token for Smithery authentication
Use cases
- Learn how to build your first MCP server with TypeScript or Python
- Understand MCP concepts through working code examples
- Set up a local development environment with the Smithery CLI playground
- Migrate an existing STDIO-based server to HTTP transport
- Deploy and host your MCP server on the Smithery platform
ai.smithery/smithery-ai-cookbook-ts-smithery-cli MCP server FAQ
It's a repository of code examples and guides for building MCP servers in TypeScript and Python. It's not a server itself, but rather a collection of templates and tutorials you can use to create your own servers.
Yes. You'll need the Smithery CLI (npm install -g @smithery/cli), Node.js 18+, Python 3.12+, and a basic understanding of the Model Context Protocol.
Clone the repository, navigate to an example directory, follow its README, and use `npx @smithery/cli playground --port 8081` to test interactively.
Yes. Once you've built and tested your server, you can deploy it to Smithery's hosted platform at smithery.ai/new to share it with others.
The cookbook includes examples in both TypeScript and Python, with quickstart, session configuration, and HTTP migration patterns for each.
Yes, the Smithery Cookbook is open-source under the MIT License. Deployment to Smithery's platform may have separate terms.
README (reference)
Source of truth, from the repository.
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
Related MCP servers
A simple tool that performs a fetch request to a webpage.
View repository →Access the GitHub API, enabling file operations, repository management, search functionality, and…
View repository →Provide real-time and forecast weather information for locations in the United States using natura…
View repository →Enable interaction with Slack workspaces. Supports subscribing to Slack events through Resources.
View repository →A Notion workspace is a collaborative environment where teams can organize work, manage projects,…
View repository →Toolbox dynamically routes to all MCPs in the Smithery registry based on your agent's need. When a…
