Proje kurulumu

Bu modül için tahmini süre: 3 dakika

Genel bakış

MCP client ve server’ların birlikte nasıl çalıştığını daha iyi anlamak için CLI tabanlı bir chatbot kuracağız. Bu uygulamalı proje, MCP mimarisinin her iki tarafıyla da elinizi kirletmenizi sağlayacak. Bu derste neyi inşa edeceğimizi tanıtacak ve geliştirme ortamını hazır hale getireceğiz.

MCP client ve server’ların birlikte nasıl çalıştığını daha iyi anlamak için CLI tabanlı bir chatbot kuracağız. Bu uygulamalı proje, MCP mimarisinin her iki tarafıyla da pratik deneyim kazandıracak.

Neyi inşa ediyoruz

Chatbot’umuz, kullanıcıların komut satırı arayüzü üzerinden bir doküman koleksiyonu ile etkileşmesini sağlayacak. Sistem iki ana bileşenden oluşuyor:

• Kullanıcı etkileşimlerini yöneten bir MCP client
• Doküman işlemlerini yöneten özel bir MCP server

Server, iki temel tool sağlayacak: biri doküman içeriklerini okumak, diğeri güncellemek için. Basit tutmak adına tüm dokümanlar bellekte saklanacak — veritabanı gerekmeyecek.

Önemli mimari notu

Gerçek dünya projelerinde tipik olarak ya bir MCP client ya da bir MCP server implement edersiniz, ikisini birden değil. Şunlardan birini yapabilirsiniz:

• Servisinizi diğer developer’lara açmak için bir MCP server oluşturmak
• Var olan MCP server’lara bağlanmak için bir MCP client geliştirmek

Bu projede her iki bileşeni de tamamen eğitim amacıyla inşa ediyoruz — birbirleriyle nasıl iletişim kurduklarını ve birlikte nasıl çalıştıklarını anlamak için.

Proje kurulumu

Bu derse iliştirilen cli_project.zip dosyasını indirin ve tercih ettiğiniz geliştirme dizinine çıkartın. Kod editörünüzü proje klasöründe açın.

Proje, kurulum talimatlarını içeren kapsamlı bir README dosyasıyla geliyor. Şu adımları izleyin:

1. Anthropic API key’inizi .env dosyasına ekleyin
2. UV (önerilir) veya pip kullanarak bağımlılıkları yükleyin
3. Her şeyin çalıştığını doğrulamak için başlangıç uygulamasını çalıştırın

Uygulamayı çalıştırmak

Terminal’de proje dizininize gidin. main.py, mcp_client.py ve mcp_server.py dahil ana proje dosyalarını göreceksiniz.

Uygulamayı başlatmak için şu komutlardan birini kullanın:

# UV kullanıyorsanız (önerilir)
uv run main.py

# Standart Python kullanıyorsanız
python main.py

Uygulama başarıyla başladığında bir chat prompt’u göreceksiniz. “what’s 1+1?” gibi basit bir soruyla test edin — Claude’dan hızlı bir yanıt almalısınız.

Temel kurulum tamamlandığına göre, MCP özelliklerini implement etmeye ve client ile server’ın Model Context Protocol üzerinden nasıl iletişim kurduğunu keşfetmeye hazırız.

Temel çıkarımlar

• Proje, dokümanları okuyup güncelleyebilen bir CLI chatbot’u
• Hem MCP client hem MCP server’ı eğitim amacıyla birlikte inşa edeceğiz
• Üretim projelerinde genelde sadece birine ihtiyaç duyarsınız
• Kurulum: .env içine API key + UV veya pip ile bağımlılıklar
• uv run main.py veya python main.py ile uygulama başlatılır