MCP Academy · Pelajaran

Tata Letak Proyek untuk Server

Atur file agar server Anda mudah dikembangkan.

Pelajaran 4 dari 413 langkah

Tata Letak Proyek untuk Server adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar MCP Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus MCP Academy mencakup 4 pelajaran total.

Struktur Menyiapkan Anda

Server kecil dapat dimuat dalam satu berkas, tetapi tata letak yang baik memungkinkannya berkembang tanpa menjadi berantakan. Sedikit perencanaan sekarang akan menghemat banyak masalah nantinya. 🗂️

Mulai dengan Satu Berkas

Sebagian besar server pada awalnya berupa satu server.py. Berkas ini memuat instans FastMCP serta satu atau dua alat, yang sudah cukup untuk mulai berjalan.

pyproject.toml Adalah Petanya

Di akar proyek terdapat pyproject.toml yang mendeklarasikan nama proyek dan dependensinya. uv membacanya untuk mengetahui dengan tepat apa yang harus diinstal.

Berkas Kunci Tetap Ada

Tepat di sebelahnya terdapat uv.lock, catatan berisi setiap versi hasil penyelesaian dependensi yang telah dikunci. Commit berkas ini agar rekan tim dapat membuat ulang penyiapan yang sama persis.

Jauhkan .venv dari Git

Folder .venv dibuat secara otomatis, bukan merupakan kode sumber. Tambahkan folder ini ke .gitignore agar Anda tidak pernah melakukan commit terhadap lingkungan yang besar dan khusus untuk mesin tertentu.

.venv/
__pycache__/

Kelompokkan Berdasarkan Primitif

Saat proyek berkembang, pisahkan kode berdasarkan fungsinya. Menempatkan tools, sumber daya, dan prompt dalam modul terpisah membuat setiap berkas tetap terfokus dan mudah dibaca.

Struktur Umum

Server yang berkembang sering kali terlihat seperti ini: titik masuk server berada di samping satu folder untuk setiap jenis kemampuan. Folder yang jelas membuat navigasi menjadi cepat. 🌳

my-server/
  server.py
  tools/
  resources/
  prompts/

Satu Titik Masuk

Pertahankan satu titik masuk yang membuat instans FastMCP dan mendaftarkan semuanya. Klien hanya perlu menjalankan satu berkas ini.

Impor, Jangan Sisipkan

Definisikan alat dalam modulnya sendiri, lalu impor dan daftarkan alat tersebut di berkas titik masuk. server.py Anda tetap singkat dan mudah dipindai.

from tools.math import register_math
register_math(mcp)

Tambahkan README

README singkat yang menjelaskan cara menginstal dan menjalankan server membuatnya mudah dibagikan. Anda di masa mendatang akan berterima kasih kepada Anda saat ini.

Simpan Rahasia di Luar Kode

Jangan pernah menulis kunci secara langsung di dalam kode. Bacalah kunci dari variabel lingkungan dan simpan contoh .env agar konfigurasi tetap aman dan portabel. 🔐

Pemeriksaan Singkat

Anda sedang menentukan apa yang harus di-commit ke pengendalian versi.

Jawab di pelajaran interaktif

Tata Letak yang Dapat Berkembang

Anda telah mempelajari cara memulai dalam satu berkas, melacak pyproject.toml dan berkas kunci, mengabaikan .venv, serta memisahkan kode berdasarkan primitif. Server Anda dapat berkembang dengan rapi. ✅

Gratis untuk memulai

Belajar Python dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 30
Pelajaran: 120

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Tata Letak Proyek untuk Server” gratis?

Ya — teks lengkap “Tata Letak Proyek untuk Server” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus MCP Academy, upgrade ke CoddyKit PRO. Kursus MCP Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Tata Letak Proyek untuk Server”?

Atur file agar server Anda mudah dikembangkan. Kamu berlatih MCP Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai MCP Academy?

Tidak diperlukan pengalaman sebelumnya. MCP Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Tata Letak Proyek untuk Server” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran MCP Academy ini?

Ya. Setiap pelajaran MCP Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke MCP Academy