Server inspector

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

Genel bakış

MCP server inşa ederken, tam bir uygulamaya bağlanmadan işlevselliği test etmenin bir yoluna ihtiyacınız olur. Python MCP SDK, tarayıcı tabanlı yerleşik bir inspector ile gelir; bu sayede server’ınızı gerçek zamanlı debug edip test edebilirsiniz. Bu derste inspector’ı başlatmayı, tool’ları test etmeyi ve geliştirme döngünüze nasıl entegre edeceğinizi göreceksiniz.

MCP server inşa ederken, tam bir uygulamaya bağlanmadan işlevselliği test etmenin bir yoluna ihtiyacınız olur. Python MCP SDK, server’ınızı gerçek zamanlı debug edip test etmenize izin veren tarayıcı tabanlı bir inspector ile gelir.

Inspector’ı başlatmak

Önce Python ortamınızın aktif olduğundan emin olun (kesin komut için projenin README’sini kontrol edin). Sonra inspector’ı şu komutla çalıştırın:

mcp dev mcp_server.py

Bu, 6277 portunda bir development server başlatır ve tarayıcıda açabileceğiniz yerel bir URL verir. Inspector arayüzü yüklendiğinde MCP Inspector dashboard’unu göreceksiniz.

Arayüz hakkında önemli not

MCP inspector aktif olarak geliştirilmekte, bu yüzden gördüğünüz arayüz mevcut ekran görüntülerinden farklı görünebilir. Ancak tool, resource ve prompt’ları test etmenin temel işlevselliği benzer kalmaya devam eder.

Bağlanma ve tool’ları test etme

MCP server’ınızı başlatmak için sol taraftaki “Connect” düğmesine tıklayın. Bağlandığınızda Resources, Prompts, Tools ve diğer özellikler için bölümler içeren bir navigation bar göreceksiniz.

Tool’larınızı test etmek için:

• Tools bölümüne gidin
• Mevcut tool’ları görmek için “List Tools”a tıklayın
• Test arayüzünü açmak için bir tool seçin
• Gerekli parametreleri doldurun
• Çalıştırıp sonuçları görmek için “Run Tool”a tıklayın

Doküman işlemlerini test etmek

Örneğin, bir doküman okuma tool’unu test etmek için bir doküman ID’si (örneğin "deposition.md") girer ve tool’u çalıştırırsınız. Inspector, dönen içerik veya başarı mesajları dahil sonucu gösterir.

İşlevselliği doğrulamak için işlemleri zincirleyebilirsiniz. Mesela bir metni değiştirerek dokümanı düzenledikten sonra hemen read tool’unu tekrar çalıştırıp değişikliklerin doğru uygulandığını teyit edebilirsiniz.

Geliştirme akışı

Inspector verimli bir geliştirme döngüsü kurar:

• MCP server kodunuzda değişiklik yapın
• Inspector üzerinden bireysel tool’ları test edin
• Tam bir uygulama kurmadan sonuçları doğrulayın
• Sorunları izole şekilde debug edin

Bu tool, daha karmaşık MCP server’lar inşa ettikçe vazgeçilmez olur. Basit işlevselliği test etmek için server’ınızı Claude’a veya başka bir uygulamaya bağlama zorunluluğunu ortadan kaldırır; geliştirme çok daha hızlı ve odaklanmış olur.

Temel çıkarımlar

• mcp dev mcp_server.py ile tarayıcı tabanlı inspector başlatılır
• Resources / Prompts / Tools bölümlerini tek arayüzden test edebilirsiniz
• “List Tools” → tool seç → parametreleri doldur → “Run Tool” akışı standart
• İşlemleri zincirleyerek (ör. edit + read) sonuçları doğrulayabilirsiniz
• Tam bir uygulama kurmadan server’ı izole şekilde debug etme imkânı sunar