smithery-mcp-deployment

Best practices for creating, optimizing, and deploying MCP servers to Smithery. Use this skill when:(1) Creating new MCP servers for Smithery deployment(2) Optimizing quality scores (achieving 90/100)(3) Troubleshooting deployment issues (0/0 tools, missing annotations, low scores)(4) Migrating existing MCP servers to Smithery format(5) Understanding Smithery's schema format requirements(6) Adding workflow prompts, tool annotations, or documentation resources(7) Configuring smithery.yaml and package.json for deployment

1. Załaduj umiejętność w Claude'a, aby uzyskać dostęp do wytycznych wdrażania serwerów MCP na Smithery. Umiejętność zawiera najlepsze praktyki i rozwiązania dla najczęstszych problemów.

2. Jeśli tworzysz nowy serwer MCP, zacznij od sprawdzenia formatu schematu — użyj zwykłych obiektów z właściwościami Zod zamiast opakowań z.object(). To jest najczęstsza przyczyna błędu "0/0 tools" przy wdrażaniu.

3. Skonfiguruj plik smithery.yaml i package.json zgodnie z wymaganiami Smithery. Umiejętność opisuje wszystkie wymagane pola i opcjonalne ustawienia, które wpływają na ocenę jakości.

4. Dodaj opisy narzędzi (2-4 zdania), adnotacje narzędzi w obiekcie konfiguracji oraz workflow prompts (3-5 promptów). Te elementy razem mogą dać ci do 60 punktów z 100 w ocenie jakości.

5. Jeśli masz problemy z wdrażaniem — brakujące adnotacje, niska ocena jakości lub błędy schematu — użyj umiejętności do diagnostyki. Zawiera konkretne rozwiązania dla każdego typu problemu.

6. Sprawdź oficjalną specyfikację MCP na context7.com/websites/modelcontextprotocol_io_specification, aby zrozumieć wymagania dotyczące narzędzi, promptów i zasobów. Umiejętność zawiera odnośnik do tego zasobu.