create-mcp-servers

Create Model Context Protocol (MCP) servers that expose tools, resources, and prompts to Claude. Use when building custom integrations, APIs, data sources, or any server that Claude should interact with via the MCP protocol. Supports both TypeScript and Python implementations.

1. Zdecyduj o architekturze serwera na podstawie liczby operacji: dla 1–2 operacji użyj wzorca tradycyjnego (każda operacja to osobne narzędzie), dla 3+ operacji zastosuj wzorzec on-demand discovery (4 meta-narzędzia plus plik operations.json).

2. Utwórz katalog serwera w strukturze ~/Developer/mcp/{nazwa-serwera}/ i przygotuj konfigurację, nigdy nie umieszczając sekretów bezpośrednio w kodzie – zamiast tego użyj zmiennych środowiskowych i rozwinięcia ${VAR} w plikach konfiguracyjnych.

3. Implementuj serwer w TypeScript lub Python, pamiętając o pięciu kluczowych regułach: nigdy nie hardkoduj sekretów, zawsze używaj właściwości cwd do izolacji zależności, stosuj ścieżki bezwzględne (sprawdź je komendą which uv), utrzymuj jeden serwer na katalog i dla projektów Python użyj uv zamiast pip.

4. Skonfiguruj uwierzytelnianie OAuth (jeśli wymagane przez API) i zoptymalizuj odpowiedzi serwera, aby były zwięzłe i efektywne dla Claude'a.

5. Zainstaluj serwer w Claude Code lub Claude Desktop, dodając go do pliku konfiguracyjnego aplikacji i weryfikując, że zmienne środowiskowe są dostępne – nigdy nie wklejaj sekretów w czat, zawsze uruchamiaj komendy w terminalu.

6. Przetestuj serwer, wywoływując jego narzędzia, zasoby i prompty z poziomu Claude'a, aby upewnić się, że integracja działa prawidłowo.