Skip to content

Latest commit

 

History

History
257 lines (190 loc) · 20.6 KB

File metadata and controls

257 lines (190 loc) · 20.6 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 aşağıdaki adımları takip edin:

  1. Depoyu Çatallayın: GitHub forks bağlantısına tıklayın.
  2. Depoyu Klonlayın: git clone https://github.com/microsoft/mcp-for-beginners.git
  3. Azure AI Foundry Discord'a katılın ve uzmanlarla, diğer geliştiricilerle tanışın

🌐 Çok Dilli Destek

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

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

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

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

🧠 Model Context Protocol Müfredatına 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ıyla yapılandırılmış bir öğrenme yolu sunar.

İster bir yapay zeka geliştiricisi, sistem mimarı, ister bir yazılım mühendisi olun, bu rehber MCP'nin temel prensiplerini ve uygulama stratejilerini öğrenmek için kapsamlı bir kaynaktır.

🔗 Resmi MCP Kaynakları

🧭 MCP Müfredatına Genel Bakış

📚 Tam Müfredat Yapısı

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

💻 Örnek Kod Projeleri

Temel MCP Hesaplayıcı Örnekleri

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

İleri Düzey MCP Uygulamaları

Dil Açıklama Bağlantı
C# Gelişmiş Örnek Kodu Görüntüle
Java with Spring Container Uygulama Örneği Kodu Görüntüle
JavaScript Gelişmiş Ö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 yararlanmak için aşağıdaki bilgilere sahip olmalısınız:

  • C#, Java, JavaScript, Python veya TypeScript dillerinden en az birinde temel programlama bilgisi

  • İstemci-sunucu modeli ve API'ler hakkında bilgi

  • REST ve HTTP kavramlarına aşinalık

  • (Opsiyonel) AI/ML kavramları hakkında temel bilgi

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

📚 Çalışma Kılavuzu ve Kaynaklar

Bu depo, size etkili bir şekilde rehberlik etmek ve öğrenmenizi kolaylaştırmak için çeşitli kaynaklar içerir:

Çalışma Kılavuzu

Bu depoyu etkili bir şekilde kullanmanıza yardımcı olacak kapsamlı bir Çalışma Kılavuzu mevcuttur. Kılavuz şunları içerir:

  • Ele alınan tüm konuları gösteren görsel bir müfredat haritası
  • Her depo bölümünün ayrıntılı bir dökümü
  • Örnek projelerin nasıl kullanılacağına dair rehberlik
  • Farklı beceri seviyeleri için önerilen öğrenme yolları
  • Öğrenme yolculuğunuzu tamamlayacak ek kaynaklar

Değişiklik Günlüğü

Müfredat materyallerine yapılan tüm önemli güncellemeleri takip eden ayrıntılı bir Değişiklik Günlüğü tutuyoruz. Bu güncellemeler şunları içerir:

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

🛠️ Bu Müfredatı Etkili Kullanma Yolları

Bu rehberdeki 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ı oluşturmak için alıştırmalar
  4. İleri düzey öğreniciler için ek kaynaklar

Etkinlikler

MCP Geliştirici Günleri'nde, AI modelleri ve bunların dayandığı araçlar arasında köprü kuran yeni standart Model Context Protocol (MCP) üzerine odaklanan, derin teknik içgörüler, topluluk bağlantıları ve uygulamalı öğrenme ile dolu iki güne hazır olun.
Etkinliği izlemek için etkinlik sayfamızdan kayıt olabilirsiniz: https://aka.ms/mcpdevdays.

Geliştiricilerin MCP'yi iş akışlarında kullanmalarını güçlendirmek ve harika MCP topluluğunu kutlamakla ilgilidir. Arcade, Block, Okta ve Neon gibi topluluk üyeleri ve ortaklarla birlikte, Microsoft ile iş birliği yaparak açık, genişletilebilir bir MCP ekosistemi oluşturma süreçlerini göreceğiz.
Gerçek dünya demoları: VS Code, Visual Studio, GitHub Copilot ve popüler topluluk araçları
Pratik, bağlama dayalı geliştirme iş akışları
Topluluk liderliğindeki oturumlar ve içgörüler
MCP'ye yeni başlıyor ya da zaten onunla çalışıyor olsanız da, 1. Gün ilham ve uygulanabilir çıkarımlarla dolu bir başlangıç sunacak.

MCP geliştiricileri için. MCP sunucuları oluşturma ve bunları AI iş akışlarına entegre etme stratejileri ve en iyi uygulamaları derinlemesine ele alınacak.

Konular şunları içerir:

  • MCP Sunucuları oluşturma ve bunları ajan deneyimlerine entegre etme
  • İstek odaklı geliştirme
  • Güvenlik en iyi uygulamaları
  • Functions, ACA ve API Management gibi yapı taşlarını kullanma
  • Kayıt hizalaması ve araçlar (1P + 3P)

Bir geliştirici, araç oluşturucu veya AI ürün stratejistiyseniz, bu gün ölçeklenebilir, güvenli ve geleceğe hazır MCP çözümleri oluşturmak için ihtiyaç duyduğunuz içgörülerle dolu.

MCP Boot Camp Ağustos 2025

MCP sunucuları oluşturmayı, VS Code ile entegre etmeyi ve MCP için Başlangıç Müfredatı'ndan içeriklere dayalı olarak Azure'da profesyonel bir şekilde dağıtmayı öğrenin. Yoğun video oturumlarında pratik beceriler kazanın ve büyük şirketlerin zaten kullandığı bir teknolojiye hakim olun.

🌟 Topluluk Teşekkürü

Önemli kod örnekleri katkılarından dolayı Microsoft Değerli Profesyonel Shivam Goyal’a teşekkürler.

📜 Lisans Bilgileri

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

🤝 Katkı Rehberi

Bu proje katkıları ve önerileri memnuniyetle karşılar. Çoğu katkı, bir Katkı Lisans Sözleşmesi (CLA) imzalamanızı gerektirir. Bu sözleşme, katkınızı kullanma haklarını bize verdiğinizi ve bu haklara sahip olduğunuzu beyan eder. Ayrıntılar için https://cla.opensource.microsoft.com adresini ziyaret edin.

Bir pull request gönderdiğinizde, bir CLA botu otomatik olarak bir CLA sağlayıp sağlamanız gerektiğini belirleyecek ve PR'ı uygun şekilde işaretleyecektir (ör. durum kontrolü, yorum). Bot tarafından sağlanan talimatları takip edin. Bu işlemi tüm CLA kullanan depolar için yalnızca bir kez yapmanız yeterlidir.

Bu proje Microsoft Açık Kaynak Davranış Kuralları benimsemiştir. Daha fazla bilgi için Davranış Kuralları SSS sayfasına bakın veya opencode@microsoft.com adresine ek sorularınızı veya yorumlarınızı gönderin.

📂 Depo Yapısı

Depo şu şekilde organize edilmiştir:

  • Temel Müfredat (00-10): On ardışık 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örsel versiyonları
  • study_guide.md: Depoyu gezinmek için kapsamlı rehber
  • changelog.md: Müfredat materyallerine yapılan tüm önemli değişikliklerin kaydı
  • mcp.json: MCP spesifikasyonu için 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 üretiyor! Göz atın:

™️ Marka Bildirimi

Bu proje, projeler, ürünler veya hizmetler için ticari markalar veya logolar içerebilir. Microsoft ticari markalarının veya logolarının yetkili kullanımı, Microsoft'un Ticari Marka ve Marka Yönergeleri ile uyumlu olmalıdır.
Bu projenin değiştirilmiş sürümlerinde Microsoft ticari markalarının veya logolarının kullanımı, kafa karışıklığına neden olmamalı veya Microsoft sponsorluğu ima etmemelidir. Üçüncü taraf ticari markalarının veya logolarının kullanımı, 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 hata veya yanlışlıklar içerebileceğini lütfen unutmayın. Belgenin orijinal dili, yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımından kaynaklanan yanlış anlamalar veya yanlış yorumlamalardan sorumlu değiliz.