Kurs 01: Prosty serwer MCP

Z MCP Wiki

Co robimy na tym kursie

Stworzymy własny serwer MCP przy użyciu Vibe Coding. W poniższym przykładzie tworzymy serwer, który otwiera dowolną stronę WWW, ale możesz zastosować tę poradę do stworzenia serwera o innej funkcjonalności.

Jak to zrobić

1. Skopiuj kod w pythonie:

import logging
from datetime import datetime

from fastmcp import FastMCP
import uvicorn

# Logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

tool_name = "TODO"
mcp = FastMCP(name=tool_name)

@mcp.tool()
async def get_current_time() -> str:
    """Zwraca aktualny czas"""
    current_time = datetime.now().strftime("%H:%M:%S")
    logger.info(f"Czas pobrany: {current_time}")
    return current_time

# TODO: Dodaj kolejne narzędzia tutaj

if __name__ == "__main__":
    port = 8124
    print(f"claude mcp add --transport http {tool_name} http://localhost:{port}/mcp/")
    uvicorn.run(mcp.http_app(transport="streamable-http"), host="localhost", port=port)

2. Każ chatowi dodac jakąś funkcjonalność

W jakimś ChatGPT wpisz polecenie, np. "Dodaj toola, który uruchomi wybraną stronę na podstawie URL", i wklej tam również skopiowany kod.

3. Zapisz i uruchom

Stworzony kod zapisz do pliku np. "srv01.py" i uruchom: python3 srv01.py. Jesli będa błedy to najwyżej trzeba doinstalować zależności. Poradzisz sobie.

4. Zainstaluj i uruchom claude

Stwórz nowy (pusty) folder, przejdź do niego i w konsoli wpisz claude. Przy pierwszym uruchomieniu pojawi się prośba o dostęp do folderu — należy ją zaakceptować.

5. Zamknij claude

Jeśli widzisz, że Claude działa, zamknij go — wpisz exit albo naciśnij dwukrotnie Ctrl+C.

6. Dodaj do claude stworzony przez siebie serwer MCP

Twój serwer po uruchomieniu wyświetlił — pomiędzy liniami z „----------” — komendę, dzięki której możesz dodać ten serwer do Claude’a. Jeśli zamknąłeś już Claude’a, skopiuj ten wiersz i uruchom go w konsoli.

7. Uruchom ponownie claude i sprawdź czy serwer działa

Ponownie uruchom Claude’a, wpisując w konsoli po prostu claude. Następnie wpisz /mcp — powinieneś zobaczyć swój nowy serwer MCP. Możesz też wejść głębiej i sprawdzić, jakie toolsy udostępniasz.

8. Użyj polecenia

Z menu MCP możesz wyjść, naciskając Esc. Gdy pojawi się możliwość wpisania komendy, wpisz polecenie związane z dodaną funkcjonalnością (np. „pokaż stronę ze specyfikacją MCP”).

9. Uśmiechnij sie lub płacz

Niech Twoja reakcja będzie adekwatna.

10. Napisz w komentarzu np. pod filmem na Youtube, czy sie udało

Jeśli się udało, to napisz. Jeśli się nie udało, to też! Pytania i opinie mile widziane. Łapki w górę też.