Mengakses Objek Konteks
Akses konteks permintaan di dalam alat.
Mengakses Objek Konteks adalah pelajaran MCP Academy gratis di CoddyKit. Ini adalah pelajaran 3 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.
Kenali Objek Context
Objek Context adalah gerbang tool Anda ke permintaan: objek ini membawa keadaan bersama serta pembantu untuk logging dan kemajuan.
Minta Berdasarkan Tipe
Tambahkan parameter dengan anotasi tipe Context, lalu FastMCP akan menyuntikkannya secara otomatis. Klien tidak pernah melihat argumen ini.
from mcp.server.fastmcp import Context
@mcp.tool()
async def greet(name: str, ctx: Context) -> str:
return "hi " + nameAkses Keadaan Bersama
Telusuri ctx.request_context.lifespan_context untuk mendapatkan objek persis yang dihasilkan lifespan saat startup.
app = ctx.request_context.lifespan_context
rows = await app.db.query("...")Gunakan Koneksi Aktif
Sekarang tool Anda bekerja menggunakan kumpulan koneksi bersama, bukan membuka koneksi baru setiap kali dipanggil.
Catat Melalui Context
Panggil ctx.info untuk mengirimkan baris log kepada klien, yang jauh lebih berguna daripada print tersembunyi di server.
await ctx.info("loading user " + str(user_id))Laporkan Kemajuan Juga
Untuk pekerjaan yang lambat, ctx.report_progress mengalirkan pembaruan persentase penyelesaian agar host dapat menampilkan bilah kemajuan kepada pengguna.
await ctx.report_progress(progress=3, total=10)Disuntikkan, Bukan Diteruskan
Model tidak pernah mengisi ctx. FastMCP mengenali anotasi tipe dan menyediakannya, sehingga ctx tidak masuk ke skema tool Anda.
Tool Asinkron Menyukai Context
Sebagian besar pembantu konteks dapat ditunggu, jadi definisikan tool yang menggunakan konteks sebagai fungsi asinkron agar dapat memanggilnya dengan rapi.
Beri Nama Apa Saja
Nama parameter terserah Anda; anotasi tipe-lah yang penting. Berdasarkan konvensi, orang sering menamainya ctx.
Satu Konteks per Permintaan
Setiap pemanggilan tool mendapatkan konteks permintaan sendiri, tetapi semuanya menunjuk ke keadaan lifespan yang sama dan berumur panjang di baliknya.
Baca Metadata Permintaan
Konteks juga menyediakan metadata permintaan, sehingga tool dapat memeriksa detail tentang pemanggilan tertentu yang sedang ditanganinya.
Pemeriksaan Singkat
Bagaimana cara mendapatkan objek Context di dalam tool FastMCP?
Ringkasan: Objek Context
Anda mengakses keadaan bersama melalui ctx.request_context.lifespan_context dan menggunakan ctx untuk logging serta kemajuan. Selanjutnya: mematikan server dengan bersih. 🔌
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Mengakses Objek Konteks” gratis?
Ya — teks lengkap “Mengakses Objek Konteks” 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 “Mengakses Objek Konteks”?
Akses konteks permintaan di dalam alat. 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 3 dari 4.
Berapa lama pelajaran “Mengakses Objek Konteks” 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
- Hook Startup Lifespan
- Berbagi Status melalui Konteks Aplikasi
- Mengakses Objek Konteks
- Mematikan dengan Bersih dan Melepaskan Sumber Daya