W ostatnim czasie coraz częściej słyszymy o Model Context Protocol (MCP) – nowym sposobie komunikacji między modelami językowymi (LLM), a rzeczywistym światem narzędzi, API i urządzeń. W tym filmie pokażę Ci krok po kroku, jak zbudować własny prosty serwer MCP, przetestować go lokalnie i połączyć z AI za pomocą aplikacji Cloud Desktop.

Czym jest MCP?

MCP (Model Context Protocol) to format, który pozwala modelowi językowemu (np. Claude, GPT) „zrozumieć”, jakie narzędzia ma dostępne i jak z nich skorzystać. W uproszczeniu – zamieniamy słowa w czyny.

Zamiast tylko mówić: „Zgaś światło”, model językowy dzięki MCP może wykonać konkretne zapytanie do odpowiedniego API, np. Smart Żarówki. Wszystko to dzieje się dzięki definicji narzędzi po stronie serwera MCP.

Tworzymy własny serwer MCP w Cursor AI

Do stworzenia serwera MCP użyłem Cursor AI – edytora kodu z wbudowaną sztuczną inteligencją. Wystarczy odpowiednio sformułowany prompt, by automatycznie wygenerować strukturę projektu, zależności oraz cały kod serwera.

👇 Poniżej znajdziesz prompt, który wykorzystałem:

Stwórz serwer MCP w Node.js o nazwie Smart Zarowka, który spełnia poniższe wymagania:

Ogólne:
* Serwer ma być oparty o Model Context Protocol (MCP), wykorzystując bibliotekę @modelcontextprotocol/server.
* Serwer ma byc stworzony zgodnie z dokumentacją MCP @https://modelcontextprotocol.io/introduction  
* Ma obsługiwać jedno narzędzie o nazwie zmien_swiatlo.
* Projekt ma być w pełni działający, gotowy do uruchomienia z aplikacją Claude Desktop jako serwer MCP
* Projekt ma zostać stworzony w TypeScript

Narzędzie zmien_swiatlo:
Parametry:
* nowy_kolor (typ string) – kolor w formacie HEX (np. #FFAABB).
* stan (typ string, dozwolone wartości: "wlacz", "wylacz") – określa, czy żarówka ma się zapalić czy zgasić.

Funkcjonalność:
W przypadku "wlacz", należy:
* Włączyć żarówkę.
* Ustawić jej kolor na nowy_kolor.

W przypadku "wylacz", należy:
* Wyłączyć żarówkę.

Połączenie z TUYA API:
* Użyj biblioteki tuya-cloud-api do komunikacji z chmurą TUYA.
* Konfiguracja TUYA (klucze API, device ID) ma być pobierana z zmiennych środowiskowych (process.env).
* Serwer powinien samodzielnie uwierzytelniać się i automatycznie zarządzać tokenami (tuya-cloud-api to obsługuje).

Dodatkowe wymagania:
* Użyj biblioteki tinycolor2 do konwersji koloru z HEX do HSV.
* Przy błędnym formacie HEX (np. niepoprawny kolor), serwer powinien zgłosić czytelny błąd.
* Dodaj obsługę podstawowych błędów (np. problem z połączeniem do TUYA).

Co generuje Cursor AI?

Na podstawie powyższego promptu Cursor AI wygenerował:

• plik package.json z zależnościami (m.in. mcp-server, zod),
• główny plik serwera z definicją narzędzia zmień światło,
• funkcje pomocnicze do łączenia się z API Tuya i konwersji kolorów,
• walidację parametrów za pomocą biblioteki zod,
• pełną obsługę JSON-RPC i odpowiedzi serwera.

Kod wymagał jednej drobnej poprawki związanej z wersją komendy Tuya do zmiany koloru światła – warto o tym pamiętać, dopasowując go do swojego urządzenia.

Testowanie serwera MCP lokalnie

Do debugowania i testów posłużyłem się narzędziem Inspector, które umożliwia:

• sprawdzenie poprawności połączenia z serwerem,
• symulację działania narzędzi,
• podejrzenie struktury parametrów i odpowiedzi.

Wszystko działało bez zarzutu – żarówka zmieniała kolor i reagowała na komendy.

Integracja z Cloud Desktop

Na koniec skonfigurowałem serwer MCP w aplikacji Cloud Desktop, stworzonej przez Anthropic – twórców modeli serii Claude. Po dodaniu odpowiedniego wpisu do pliku config.json, AI mogła już korzystać z narzędzia zmień światło.

Wystarczyło napisać:
„Idę spać, zgaś światło”,
a model sam zidentyfikował potrzebne narzędzie, poprosił o zgodę, a następnie zgasił żarówkę.

Co dalej?

Serwer, który stworzyliśmy, jest bardzo prosty – steruje tylko jedną żarówką. Ale MCP ma znacznie większy potencjał.

Pracuję obecnie nad rozbudowanym serwerem MCP dla WordPressa, który:

• komunikuje się z REST API WP,
• uruchamia komendy WP-CLI,
• generuje i testuje motywy, wtyczki oraz bloki Gutenberga.

Jeśli chcesz otrzymać dostęp do tego narzędzia, zapisz się do listy oczekujących: https://ctowiec.pl/mcp-wordpress/