Układ projektu serwera
Uporządkuj pliki tak, aby łatwo było rozwijać serwer.
Układ projektu serwera to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.
Struktura zapewnia dobry start
Mały serwer mieści się w jednym pliku, ale dobra organizacja pozwala mu rosnąć bez zamieniania projektu w bałagan. Odrobina planowania teraz oszczędzi wielu problemów później. 🗂️
Zacznij od jednego pliku
Większość serwerów zaczyna jako pojedynczy plik server.py. Zawiera on instancję FastMCP oraz jedno lub dwa narzędzia — wystarczająco dużo, aby rozpocząć pracę.
pyproject.toml to mapa projektu
W katalogu głównym znajduje się pyproject.toml, który deklaruje nazwę projektu i jego zależności. uv odczytuje go, aby dokładnie wiedzieć, co zainstalować.
Lockfile pozostaje na miejscu
Tuż obok znajduje się uv.lock — zapis wszystkich rozstrzygniętych wersji. Zatwierdź go w repozytorium, aby członkowie zespołu mogli odtworzyć dokładnie tę samą konfigurację.
Nie dodawaj .venv do Git
Folder .venv jest generowany, a nie zawiera kodu źródłowego. Dodaj go do .gitignore, aby nigdy nie zatwierdzić dużego środowiska zależnego od konkretnego komputera.
.venv/
__pycache__/Grupuj według rodzaju elementu
W miarę rozwoju projektu dziel kod według jego przeznaczenia. Umieszczenie tools, zasobów i promptów w osobnych modułach sprawia, że każdy plik pozostaje przejrzysty i skupiony na jednym zadaniu.
Typowa struktura
Rozwijający się serwer często wygląda tak: punkt wejścia serwera obok osobnego folderu dla każdego rodzaju funkcji. Jasna struktura folderów przyspiesza nawigację. 🌳
my-server/
server.py
tools/
resources/
prompts/Jeden punkt wejścia
Zachowaj jeden punkt wejścia, który tworzy instancję FastMCP i rejestruje wszystkie elementy. Klienci muszą uruchamiać tylko ten jeden plik.
Importuj, nie umieszczaj kodu bezpośrednio
Definiuj narzędzia w osobnych modułach, a następnie importuj je i rejestruj w pliku wejściowym. Dzięki temu server.py pozostaje krótki i łatwy do przejrzenia.
from tools.math import register_math
register_math(mcp)Dodaj README
Krótki plik README z instrukcją instalacji i uruchamiania serwera ułatwia jego udostępnianie. Przyszła wersja Ciebie podziękuje obecnej za jego przygotowanie.
Przechowuj sekrety poza kodem
Nigdy nie umieszczaj kluczy na stałe w kodzie. Odczytuj je ze zmiennych środowiskowych i przechowuj przykładowy plik .env, aby konfiguracja pozostała bezpieczna i przenośna. 🔐
Szybkie sprawdzenie
Decydujesz, co zatwierdzić w systemie kontroli wersji.
Struktura, która skaluje się wraz z projektem
Wiesz już, jak zacząć od jednego pliku, śledzić w repozytorium pyproject.toml i lockfile, ignorować .venv oraz dzielić kod według rodzaju elementu. Twój serwer może teraz rozwijać się w uporządkowany sposób. ✅
Często zadawane pytania
Czy lekcja „Układ projektu serwera” jest bezpłatna?
Tak — pełny tekst „Układ projektu serwera” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Układ projektu serwera”?
Uporządkuj pliki tak, aby łatwo było rozwijać serwer. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć MCP Academy?
Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Układ projektu serwera”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?
Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Instalacja Python i uv
- Dodawanie Python SDK dla MCP
- Poznaj CLI mcp
- Układ projektu serwera