Skip to content

Latest commit

 

History

History
257 lines (187 loc) · 19.8 KB

File metadata and controls

257 lines (187 loc) · 19.8 KB

MCP-for-beginners

GitHub contributors GitHub issues GitHub pull-requests PRs Welcome

GitHub watchers GitHub forks GitHub stars

Microsoft Azure AI Foundry Discord

Bu kaynakları kullanmaya başlamak için şu adımları izleyin:

  1. Depoyu Forklayın: Tıklayın GitHub forks
  2. Depoyu Klonlayın: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Azure AI Foundry Discord’a Katılın ve uzmanlar ile diğer geliştiricilerle tanışın

🌐 Çok Dilli Destek

GitHub Action ile Desteklenmektedir (Otomatik ve Her Zaman Güncel)

Fransızca | İspanyolca | Almanca | Rusça | Arapça | Farsça (Persian) | Urduca | Çince (Basitleştirilmiş) | Çince (Geleneksel, Makao) | Çince (Geleneksel, Hong Kong) | Çince (Geleneksel, Tayvan) | Japonca | Korece | Hintçe | Bengalce | Marathi | Nepalce | Pencapça (Gurmukhi) | Portekizce (Portekiz) | Portekizce (Brezilya) | İtalyanca | Lehçe | Türkçe | Yunanca | Tayca | İsveççe | Danca | Norveççe | Fince | Flemenkçe | İbranice | Vietnamca | Endonezce | Malayca | Tagalogca (Filipince) | Svahili | Macarca | Çekçe | Slovakça | Rumence | Bulgarca | Sırpça (Kiril) | Hırvatça | Slovence | Ukraynaca | Birmanca (Myanmar)

🚀 Model Context Protocol (MCP) Başlangıç Müfredatı

C#, Java, JavaScript, Python ve TypeScript ile MCP’yi Uygulamalı Kod Örnekleriyle Öğrenin

🧠 Model Context Protocol Müfredatı Genel Bakış

Model Context Protocol (MCP), yapay zeka modelleri ile istemci uygulamaları arasındaki etkileşimleri standartlaştırmak için tasarlanmış ileri düzey bir çerçevedir. Bu açık kaynaklı müfredat, C#, Java, JavaScript, TypeScript ve Python gibi popüler programlama dillerinde pratik kod örnekleri ve gerçek dünya kullanım senaryoları içeren yapılandırılmış bir öğrenme yolu sunar.

İster bir yapay zeka geliştiricisi, sistem mimarı ya da yazılım mühendisi olun, bu rehber MCP’nin temel kavramlarını ve uygulama stratejilerini öğrenmeniz için kapsamlı bir kaynaktır.

🔗 Resmi MCP Kaynakları

MCP Dev Days 29-30 Temmuz 2025’e Katılın

Model Context Protocol (MCP) — yapay zeka modelleri ile kullandıkları araçlar arasında köprü kuran yükselen standart — için düzenlenen MCP Dev Days etkinliğinde iki gün boyunca derin teknik bilgiler, topluluk bağlantıları ve uygulamalı öğrenme fırsatları sizi bekliyor.

➡️ MCP Dev Days için Kayıt Olun

MCP Dev Days’i etkinlik sayfamızdan kayıt olarak izleyebilirsiniz: https://aka.ms/mcpdevdays. Buradan YouTube veya Twitch üzerinden canlı yayına katılabilirsiniz. Tüm içerikler kaydedilecek ve sonrasında Microsoft Developer YouTube kanalında erişime açılacaktır. Demo kaynak kodları da GitHub’da paylaşılacaktır.

Etkinlik Detayları

  • Tarihler: 29 Temmuz (1. Gün) & 30 Temmuz (2. Gün)
  • Saat: Her gün 9:00 AM PST
  • Yer: Çevrimiçi – her yerden katılabilirsiniz!

1. Gün: MCP Verimliliği, Geliştirici Araçları ve Topluluk

Geliştiricilerin MCP’yi iş akışlarına entegre etmelerini desteklemek ve harika MCP topluluğunu kutlamak üzerine. Microsoft ile iş birliği yapan Arcade, Block, Okta ve Neon gibi topluluk üyeleri ve ortaklarıyla birlikte açık ve genişletilebilir bir MCP ekosisteminin nasıl şekillendiğini göreceğiz. VS Code, Visual Studio, GitHub Copilot ve popüler topluluk araçları üzerinden gerçek dünya demoları Pratik, bağlam odaklı geliştirme iş akışları Topluluk liderliğinde oturumlar ve içgörüler MCP’ye yeni başlayanlar ya da hali hazırda kullananlar için 1. Gün ilham verici ve uygulanabilir bilgilerle dolu olacak.

2. Gün: MCP Sunucularını Güvenle İnşa Etmek

MCP geliştiricileri için. MCP sunucuları oluşturma ve MCP’yi yapay zeka iş akışlarınıza entegre etme konusunda uygulama stratejileri ve en iyi uygulamalara derinlemesine dalış yapacağız.

Konular arasında:

  • MCP Sunucuları oluşturma ve bunları ajan deneyimlerine entegre etme
  • İstek odaklı geliştirme
  • Güvenlik en iyi uygulamaları
  • Fonksiyonlar, ACA ve API Yönetimi gibi yapı taşlarının kullanımı
  • Kayıt uyumu ve araçlar (1P + 3P)

Geliştirici, araç yapımcısı veya yapay zeka ürün stratejistiyseniz, bu gün ölçeklenebilir, güvenli ve geleceğe hazır MCP çözümleri oluşturmak için ihtiyacınız olan bilgilerle dolu.

🧭 MCP Müfredatı Genel Bakış

📚 Tam Müfredat Yapısı

Modül Konu Açıklama Bağlantı
Modül 1-3: Temeller
00 MCP’ye Giriş Model Context Protocol’ün genel bakışı ve yapay zeka süreçlerindeki önemi Devamını oku
01 Temel Kavramlar MCP’nin temel kavramlarının derinlemesine incelenmesi Devamını oku
02 MCP’de Güvenlik Güvenlik tehditleri ve en iyi uygulamalar Devamını oku
03 MCP ile Başlarken Ortam kurulumu, temel sunucular/istemciler, entegrasyon Devamını oku
Modül 3: İlk Sunucu ve İstemcinizi Oluşturma
3.1 İlk Sunucu İlk MCP sunucunuzu oluşturun Kılavuz
3.2 İlk İstemci Temel bir MCP istemcisi geliştirin Kılavuz
3.3 LLM ile İstemci Büyük dil modellerini entegre edin Kılavuz
3.4 VS Code Entegrasyonu MCP sunucularını VS Code’da kullanın Kılavuz
3.5 SSE Sunucusu Server-Sent Events kullanarak sunucular oluşturun Kılavuz
3.6 HTTP Akışı MCP’de HTTP akışını uygulayın Kılavuz
3.7 AI Araç Seti MCP ile AI Araç Setini kullanın Kılavuz
3.8 Test Etme MCP sunucu uygulamanızı test edin Kılavuz
3.9 Dağıtım MCP sunucularını üretime dağıtın Kılavuz
Modül 4-5: Pratik ve İleri Düzey
04 Pratik Uygulama SDK’lar, hata ayıklama, test, yeniden kullanılabilir istek şablonları Devamını oku
05 MCP’de İleri Konular Çok modlu yapay zeka, ölçeklendirme, kurumsal kullanım Devamını oku
5.1 Azure Entegrasyonu MCP’nin Azure ile entegrasyonu Kılavuz
5.2 Çok Modluluk Birden fazla modalite ile çalışma Kılavuz
5.3 OAuth2 Demo OAuth2 kimlik doğrulamasını uygulama Kılavuz
5.4 Kök Bağlamlar Kök bağlamları anlama ve uygulama Kılavuz
5.5 Yönlendirme MCP yönlendirme stratejileri Kılavuz
5.6 Örnekleme MCP’de örnekleme teknikleri Kılavuz
5.7 Ölçeklendirme MCP uygulamalarını ölçeklendirme Kılavuz
5.8 Güvenlik İleri düzey güvenlik konuları Kılavuz
5.9 Web Arama Web arama özelliklerini uygulama Kılavuz
5.10 Gerçek Zamanlı Akış Gerçek zamanlı akış işlevselliği oluşturma Kılavuz
5.11 Gerçek Zamanlı Arama Gerçek zamanlı arama uygulama Kılavuz
5.12 Entra ID Kimlik Doğrulama Microsoft Entra ID ile Kimlik Doğrulama Kılavuz
5.13 Foundry Entegrasyonu Azure AI Foundry ile Entegrasyon Kılavuz
5.14 Bağlam Mühendisliği Etkili bağlam mühendisliği teknikleri Kılavuz
Modül 6-10: Topluluk & En İyi Uygulamalar
06 Topluluk Katkıları MCP ekosistemine nasıl katkıda bulunulur Kılavuz
07 Erken Benimsemeden Alınan Dersler Gerçek dünya uygulama hikayeleri Kılavuz
08 MCP için En İyi Uygulamalar Performans, hata toleransı, dayanıklılık Kılavuz
09 MCP Vaka Çalışmaları Pratik uygulama örnekleri Kılavuz
10 Uygulamalı Atölye AI Araç Seti ile MCP Sunucusu Kurma Laboratuvar

💻 Örnek Kod Projeleri

Temel MCP Hesaplayıcı Örnekleri

Dil Açıklama Bağlantı
C# MCP Sunucu Örneği Kodu Görüntüle
Java MCP Hesaplayıcı Kodu Görüntüle
JavaScript MCP Demo Kodu Görüntüle
Python MCP Sunucu Kodu Görüntüle
TypeScript MCP Örneği Kodu Görüntüle

İleri Düzey MCP Uygulamaları

Dil Açıklama Bağlantı
C# İleri Düzey Örnek Kodu Görüntüle
Java Container Uygulama Örneği Kodu Görüntüle
JavaScript İleri Düzey Örnek Kodu Görüntüle
Python Karmaşık Uygulama Kodu Görüntüle
TypeScript Container Örneği Kodu Görüntüle

🎯 MCP Öğrenimi için Ön Koşullar

Bu müfredattan en iyi şekilde faydalanmak için:

  • En az bir programlama dilinde temel bilgi sahibi olmalısınız: C#, Java, JavaScript, Python veya TypeScript

  • İstemci-sunucu modeli ve API’leri anlamalısınız

  • REST ve HTTP kavramlarına aşina olmalısınız

  • (İsteğe bağlı) AI/ML kavramları hakkında temel bilgi sahibi olmak faydalıdır

  • Destek için topluluk tartışmalarımıza katılmak

📚 Çalışma Rehberi & Kaynaklar

Bu depo, etkili öğrenmenize yardımcı olacak çeşitli kaynaklar içerir:

Çalışma Rehberi

Bu depoyu etkili kullanmanız için kapsamlı bir Çalışma Rehberi mevcuttur. Rehberde şunlar yer alır:

  • Tüm konuları gösteren görsel müfredat haritası
  • Her depo bölümünün detaylı açıklaması
  • Örnek projelerin nasıl kullanılacağına dair yönlendirmeler
  • Farklı beceri seviyeleri için önerilen öğrenme yolları
  • Öğrenme sürecinizi destekleyecek ek kaynaklar

Değişiklik Günlüğü

Müfredat materyallerindeki önemli güncellemeleri takip ettiğimiz ayrıntılı bir Değişiklik Günlüğü bulunmaktadır. İçeriği:

  • Yeni içerik eklemeleri
  • Yapısal değişiklikler
  • Özellik iyileştirmeleri
  • Dokümantasyon güncellemeleri

🛠️ Bu Müfredatı Etkili Kullanma Yöntemleri

Bu kılavuzdaki her ders şunları içerir:

  1. MCP kavramlarının net açıklamaları
  2. Birden fazla dilde canlı kod örnekleri
  3. Gerçek MCP uygulamaları geliştirmek için alıştırmalar
  4. İleri düzey öğrenenler için ek kaynaklar

🌟 Topluluğa Teşekkürler

Önemli kod örnekleriyle katkıda bulunan Microsoft Değerli Uzmanı Shivam Goyal’a teşekkür ederiz.

📜 Lisans Bilgisi

Bu içerik MIT Lisansı altında lisanslanmıştır. Şartlar ve koşullar için LICENSE dosyasına bakınız.

🤝 Katkı Rehberi

Bu proje katkı ve önerilere açıktır. Çoğu katkı için, katkınızın kullanım haklarını bize verdiğinizi beyan eden bir Katkı Lisans Anlaşması (CLA) imzalamanız gerekir. Detaylar için
https://cla.opensource.microsoft.com adresini ziyaret edin.

Bir pull request gönderdiğinizde, CLA botu otomatik olarak CLA gerekip gerekmediğini belirler ve PR’ı uygun şekilde işaretler (örneğin, durum kontrolü, yorum). Botun verdiği talimatları izleyin. Bu işlemi, CLA kullanan tüm depolarda sadece bir kez yapmanız yeterlidir.

Bu proje Microsoft Açık Kaynak Davranış Kuralları’nu benimsemiştir. Daha fazla bilgi için Davranış Kuralları SSS sayfasına bakabilir veya ek sorularınız için opencode@microsoft.com adresine yazabilirsiniz.

📂 Depo Yapısı

Depo şu şekilde organize edilmiştir:

  • Temel Müfredat (00-10): On modülde düzenlenmiş ana içerik
  • images/: Müfredat boyunca kullanılan diyagramlar ve görseller
  • translations/: Otomatik çevirilerle çok dilli destek
  • translated_images/: Yerelleştirilmiş diyagram ve görseller
  • study_guide.md: Depoyu kullanmak için kapsamlı rehber
  • changelog.md: Müfredat materyallerindeki önemli değişikliklerin kaydı
  • mcp.json: MCP spesifikasyon yapılandırma dosyası
  • CODE_OF_CONDUCT.md, LICENSE, SECURITY.md, SUPPORT.md: Proje yönetim belgeleri

🎒 Diğer Kurslar

Ekibimiz başka kurslar da sunuyor! Göz atın:

™️ Marka Bildirimi

Bu projede, projeler, ürünler veya hizmetler için ticari markalar veya logolar bulunabilir. Microsoft ticari markalarının veya logolarının yetkili kullanımı,
Microsoft’un Ticari Marka & Marka Yönergeleri kurallarına tabidir ve bunlara uygun olmalıdır.
Microsoft ticari markalarının veya logolarının bu projenin değiştirilmiş sürümlerinde kullanımı, karışıklığa yol açmamalı veya Microsoft sponsorluğunu ima etmemelidir.
Üçüncü taraf ticari markalarının veya logolarının kullanımı ise ilgili üçüncü tarafların politikalarına tabidir.

Feragatname:
Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu oluşabilecek yanlış anlamalar veya yorum hatalarından sorumlu değiliz.