PricingLoginStart free
MCP Academy · Ders

Bir Hello Aracı Ekleme

Yapay zekânın çağırabilmesi için bir Python işlevine dekoratör ekleyin.

2. ders / 413 adım

Bir Hello Aracı Ekleme, CoddyKit'te ücretsiz bir MCP Academy dersidir. Bu, 4 dersinin 2. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, MCP Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. MCP Academy kursu toplamda 4 dersten oluşur.

Sunucunuza Yetenek Kazandırın

Aracı olmayan bir sunucu yalnızca boş bir kabuktur. tool, yapay zekânın kullanıcı için gerçekten bir şeyler yapmak üzere çağırabileceği bir Python işlevidir. 🛠️

Sihirli Dekoratör

FastMCP, işlev tanımınızın hemen üstüne yerleştirdiğiniz @mcp.tool() dekoratörüyle bir işlevi tek satırda araca dönüştürür.

@mcp.tool()
def hello():
    ...

Normal Bir İşlev Yazın

Gövde yalnızca Python kodudur. Özel protokol kodu yazmanız veya JSON'u elle oluşturmanız gerekmez. Aracın ne yapması gerektiğini yazıp bir değer döndürürsünüz.

@mcp.tool()
def hello():
    return "Hello from MCP!"

Parametre Ekleyin

Araçlar girdiyle daha kullanışlı hâle gelir. Bir parametre eklediğinizde model, aracınızı çağırmaya karar verdiğinde bir değer iletebilir.

@mcp.tool()
def greet(name):
    return "Hello, " + name

Tür İpuçları Şemayı Oluşturur

name: str gibi bir tür ipucu eklediğinizde FastMCP bunu bir girdi şemasına dönüştürür. Böylece model, göndermesi gereken değerin türünü tam olarak bilir.

@mcp.tool()
def greet(name: str) -> str:
    return "Hello, " + name

Belge Dizesi Açıklamaya Dönüşür

İşlevinizin belge dizesi, aracın açıklamasına dönüşür. Model, bu aracı ne zaman kullanmanın uygun olduğuna karar vermek için bu açıklamayı okur.

@mcp.tool()
def greet(name: str) -> str:
    """Greet a person by name."""
    return "Hello, " + name

Ad İşlevden Gelir

Varsayılan olarak aracın adı, işlevin adıdır. Bu nedenle def greet, istemcinin "greet" olarak listelediği bir araç yayımlar.

Düz Metin Döndürün

İlk aracınız için yalnızca bir dize döndürün. FastMCP bunu uygun MCP sonuç biçimine sarar; böylece istemci temiz bir metin alır.

İyi Açıklayın

İyi ifade etmek önemlidir: açık bir açıklama, modelin doğru zamanda aracınızı seçmesine yardımcı olur. Belirsiz belge dizeleri çağrıların kaçırılmasına yol açar.

Otomatik Olarak Kaydedilir

Kayıt işlevini kendiniz çağırmanız gerekmez. Araç, dekoratörle işaretlendiği anda mcp örneğinize kaydedilir ve tanıtılmaya hazır hâle gelir.

İstediğiniz Kadar Ekleyin

Tek bir sunucu birçok araç barındırabilir. Her işlevi dekoratörle işaretlemeniz yeterlidir; istemci hangi araçların kullanılabildiğini sorduğunda hepsi birlikte görünür.

Hızlı Kontrol

Bir aracın açıklaması nereden gelir?

İnteraktif derste cevapla

Özet

Bir aracı @mcp.tool() ile eklediniz, tür belirtilmiş parametreler verdiniz ve belge dizesinin aracı açıklamasını sağladınız. Sunucunuz artık gerçekten bir şeyler yapabilir. Şimdi onu çalıştıralım! ✨

Başlamak ücretsiz

Yapay zeka eğitmeniyle Python öğren — ücretsiz

Tarayıcında gerçek kod yaz ve çalıştır, 7/24 yapay zeka eğitmeninden anında yardım al; web'de ya da uygulamada kaldığın yerden devam et.

Kurslar
30
Dersler
120
Ücretsiz öğrenmeye başlaTüm kursu görüntüle

Sıkça Sorulan Sorular

“Bir Hello Aracı Ekleme” dersi ücretsiz mi?

Evet — “Bir Hello Aracı Ekleme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve MCP Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. MCP Academy kursu toplamda 4 dersten oluşur.

“Bir Hello Aracı Ekleme” dersinde ne öğreneceğim?

Yapay zekânın çağırabilmesi için bir Python işlevine dekoratör ekleyin. MCP Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

MCP Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te MCP Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 2. dersidir.

“Bir Hello Aracı Ekleme” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu MCP Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her MCP Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

  1. FastMCP Örneği Oluşturma
  2. Bir Hello Aracı Ekleme
  3. Sunucuyu stdio ile Çalıştırma
  4. Yüklendiğini ve Araçları Listelediğini Doğrulama
← MCP Academy Sayfasına Dön