{
  "markdown": "# Smithery Cookbook\n\nThe 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.\n\n## Prerequisites\n\nTo make the most of the examples in this cookbook, you'll need:\n\n- **Smithery CLI**: Install with `npm install -g @smithery/cli` to access the interactive playground and development tools\n- **Programming language runtimes** for the examples you want to explore (Python 3.12+, Node.js 18+, etc.)\n- Basic understanding of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro)\n\n## Quick Start\n\n1. **Clone this repository:**\n   ```bash\n   git clone https://github.com/smithery-ai/smithery-cookbook.git\n   cd smithery-cookbook\n   ```\n\n2. **Choose an example and follow its README:**\n   ```bash\n   cd servers/python/quickstart\n   # Follow the README.md instructions\n   ```\n\n3. **Test with Smithery Playground:**\n   ```bash\n   npx @smithery/cli playground --port 8081\n   ```\n   \n   *Note: Replace `8081` with the port your server is running on*\n\n4. **Deploy to Smithery (optional):**\n   Ready to share your MCP server? [Deploy it here](https://smithery.ai/new) to host it on Smithery's platform.\n\n## Table of Recipes\n\n### Python Servers\n- **[FastMCP Quickstart](servers/python/quickstart/)** - Basic server with greeting tool\n- **[FastMCP Advanced](servers/python/server_with_session_config/)** - Server with session configuration\n- **[Migrate STDIO to HTTP](servers/python/migrate_stdio_to_http/)** - Server with custom Docker container\n\n### TypeScript Servers\n- **[TypeScript Quickstart](servers/typescript/quickstart/)** - Simple server with character counting tool\n- **[TypeScript Session Config](servers/typescript/server_with_session_config/)** - Server with session configuration\n- **[Migrate STDIO to HTTP - Smithery CLI](servers/typescript/migrate_stdio_to_http/server_with_smithery_cli/)** - Server using Smithery CLI\n- **[Migrate STDIO to HTTP - Custom Container](servers/typescript/migrate_stdio_to_http/server_with_custom_container/)** - Server with custom Docker container\n\n## Development Workflow\n\nBuild and distribute your MCP servers with Smithery:\n\n1. **Build** your MCP server using the language and framework of your choice\n2. **Test** interactively with `npx @smithery/cli playground`\n3. **Debug** with real-time request/response inspection\n4. **Deploy** to Smithery's hosted platform - [Deploy here](https://smithery.ai/new)\n5. **Distribute** your server gets its own page at `smithery.ai/server/{name}` for others to discover and use\n\n## Explore Further\n\nLooking for more resources to enhance your MCP development experience?\n\n- [Smithery Documentation](https://docs.smithery.ai) - Complete guides and API reference\n- [Deploy Your MCP Server](https://smithery.ai/new) - Host your server on Smithery's platform\n- [Model Context Protocol Specification](https://modelcontextprotocol.io/docs/getting-started/intro) - Official MCP documentation\n- [Smithery Discord Community](https://discord.gg/sKd9uycgH9) - Get help and share your projects\n\nIf you have ideas for new examples or guides, share them on the [issues page](https://github.com/smithery-ai/smithery-cookbook/issues).\n\n## License\n\nMIT License\n",
  "bytes": 3323,
  "sha": "d18c97b14407fa99a6b05409aac1c1245f22b713c5ed06e334c2435e8d389409",
  "repo_slug": "smithery-ai/smithery-cookbook",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_smithery_ai_cookbook_ts_smit_a571fc0c/readme"
}