GraphQL Şeması MCP Sunucusu

“GraphQL Şeması” MCP Sunucusu ne yapar?

GraphQL Şeması Model Bağlam Protokolü (MCP) Sunucusu, Claude gibi yapay zeka asistanlarının GraphQL şemalarıyla etkileşime geçmesini ve anlamasını sağlayan özel bir araçtır. Şema ayrıntılarını özel araçlar aracılığıyla sunarak büyük dil modellerinin sorgu, mutasyon ve abonelik alanlarını keşfetmesine, tip tanımlarını bulmasına ve şema genelinde desen eşlemeli aramalar yapmasına imkân tanır. Bu, geliştirme iş akışlarını iyileştirir; LLM’lerin API’ler hakkında ayrıntılı soruları yanıtlamasına, API entegrasyonuna yardımcı olmasına ve GraphQL tabanlı sistemlerle ilgili dokümantasyon veya kod üretim görevlerini otomatikleştirmesine olanak tanır. Sunucu, başlatıldığında belirtilen herhangi bir GraphQL şema dosyasını yükleyebilir ve şema analizi, kod keşfi ve geliştirici desteği için esnek bir temel sunar.

Komut Listesi

Depoda ya da dokümantasyonda açıkça komut şablonları belirtilmemiştir.

Kaynaklar Listesi

Dokümantasyonda ya da kodda MCP standardına göre açıkça kaynak belirtilmemiştir.

Araçlar Listesi

• list-query-fields: GraphQL sorguları için tüm mevcut kök seviye alanları listeler.
• get-query-field: Belirli bir sorgu alanının ayrıntılı tanımını SDL (Şema Tanım Dili) formatında alır.
• list-mutation-fields: GraphQL mutasyonları için tüm mevcut kök seviye alanları listeler.
• get-mutation-field: Belirli bir mutasyon alanının ayrıntılı tanımını SDL formatında alır.
• list-subscription-fields: GraphQL abonelikleri için (şema içeriyorsa) tüm kök seviye alanları listeler.
• get-subscription-field: Belirli bir abonelik alanının ayrıntılı tanımını alır (şema içeriyorsa).
• list-types: GraphQL şemasında tanımlı tüm tipleri (dahili tipler hariç) listeler.
• get-type: Belirli bir GraphQL tipinin ayrıntılı tanımını SDL formatında alır.
• get-type-fields: Belirli bir GraphQL nesne tipi için alanların ve tiplerinin sade listesini alır.
• search-schema: Şemada isim desenine (büyük/küçük harfe duyarsız regex) göre tip ya da alan araması yapar.

Bu MCP Sunucusunun Kullanım Alanları

• GraphQL API Keşfi: Geliştiricilerin ve LLM’lerin bir GraphQL API’deki mevcut sorgu, mutasyon ve abonelikleri hızla keşfetmesini sağlar, işe alım ve dokümantasyon süreçlerini hızlandırır.
• Şema Dokümantasyonu Desteği: Tip tanımlarının ve alan ayrıntılarının otomatik çıkarımını sağlayarak API dokümantasyonu oluşturma veya güncelleme işlerini destekler.
• Kod Tabanı Entegrasyonu: LLM’lerin veri modelleri ve mevcut işlemler hakkında soruları yanıtlamasına olanak tanır; GraphQL API’leriyle etkileşimli kod üretimi, test veya refaktörleme görevlerine destek olur.
• API Entegrasyonu Planlaması: Alan tiplerini, argümanları ve programlı olarak mevcut işlemleri yüzeye çıkararak API’lerle nasıl etkileşim kurulacağına dair akıllı öneriler sunar.
• Şema Arama ve Analizi: Belirli desenlerle eşleşen tip ve alanları bulmayı mümkün kılar, şema denetimleri, migrasyonları veya büyük/karmaşık API’lerin anlaşılması için yardımcı olur.

Nasıl kurulur

Windsurf

Depoda Windsurf kurulumu için açık talimat yoktur.

Claude

1. Ön Koşullar: Node.js ve npx’in kurulu olduğundan emin olun.
2. Yapılandırma Dosyasını Bulun: claude_desktop_config.json dosyasını bulun:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. Yapılandırmayı Düzenleyin: GraphQL Şeması MCP sunucusunu mcpServers nesnesine ekleyin.
4. Sunucu Ekleme: Örnek JSON yapılandırması:

   {
     "mcpServers": {
       "GraphQL Schema": {
         "command": "npx",
         "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
       }
     }
   }
   

5. Kaydedin & Yeniden Başlatın: Dosyayı kaydedin ve Claude Desktop’u yeniden başlatın.
6. Kurulumu Doğrulayın: Sunucunun çalıştığını ve Claude’da erişilebilir olduğunu kontrol edin.

Cursor

Depoda Cursor kurulumu için açık talimat yoktur.

Cline

Depoda Cline kurulumu için açık talimat yoktur.

API Anahtarlarını Güvenli Hale Getirme

Depoda API anahtarlarını güvenli hale getirme veya ortam değişkeni yapılandırması hakkında bilgi yoktur.

Bu MCP’yi iş akışlarında nasıl kullanırsınız

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, önce MCP bileşenini akışınıza ekleyin ve AI ajanınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırması bölümünde MCP sunucu bilgilerinizi şu JSON formatında girin:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırma tamamlandığında, AI ajanı artık bu MCP’yi tüm işlev ve kabiliyetlerine erişebilen bir araç olarak kullanabilir. “MCP-name” kısmını MCP sunucunuzun gerçek adıyla (ör. “github-mcp”, “weather-api” vb.) ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Yukarıdaki ayrıntılara göre, bu MCP sunucusu GraphQL şeması keşfi ve araçları için sağlamdır; ancak açık komut şablonları, kaynaklar ve anahtar yönetimi dokümantasyonu eksiktir. Kendi alanında çok odaklı ve Claude ile kullanımı için iyi dokümante edilmiştir.

Bizim görüşümüz

Bu MCP sunucusu, GraphQL şeması analizi için oldukça uzmanlaşmış ve etkilidir; güçlü araç desteği ve Claude entegrasyonu için net dokümantasyon sunar. Ancak, komut şablonlarının, açık kaynak tanımlarının ve ortam değişkeni/anahtar güvenliği yönetiminin olmaması, genel amaçlı kullanımı ve güvenli dağıtımı sınırlamaktadır. Köklere ve örnekleme desteğine değinilmemesi de gelişmiş entegrasyon senaryolarını etkileyebilir. Genel olarak, hedef kullanım alanı için güçlü ve güvenilir bir MCP’dir; ancak genellik ve güvenlik açısından geliştirilebilir.

MCP Skoru