OpenAPI Şeması MCP Sunucusu

“OpenAPI Şeması” MCP Sunucusu ne yapar?

OpenAPI Şeması MCP Sunucusu, OpenAPI şeması bilgisini Claude gibi Büyük Dil Modellerine (LLM) sunmak üzere tasarlanmış bir Model Bağlam Protokolü (MCP) sunucusudur. OpenAPI spesifikasyonlarına yapılandırılmış erişim sağlayarak, bu sunucu yapay zeka asistanlarının API’leri, uç noktalarını, parametrelerini, istek ve yanıt şemalarını ve daha fazlasını keşfetmesini ve anlamasını mümkün kılar. Bu, geliştirici ve yapay zeka araçlarının API yapılarını sorgulamasını, spesifikasyonlar arasında arama yapmasını ve ayrıntılı şema tanımlarını almasını sağlar; bu da API entegrasyonu, dokümantasyonu ve kod üretimiyle ilgili iş akışlarını güçlendirir. Sunucu, JSON veya YAML formatındaki OpenAPI dosyalarını yüklemeyi destekler ve sonuçları LLM’ler için daha iyi anlaşılır olması adına YAML olarak sunar.

İstem Listesi

Depoda açık bir istem şablonu dokümante edilmemiştir.

Kaynak Listesi

Depoda açık bir kaynak tanımı bulunmamaktadır.

Araç Listesi

OpenAPI Şeması MCP Sunucusu, LLM’ler için aşağıdaki araçları sunar:

• list-endpoints: Tüm API yollarını ve HTTP metotlarını özetleriyle birlikte iç içe bir nesne yapısında listeler.
• get-endpoint: Belirli bir uç nokta hakkında, parametreler ve yanıtlar dahil ayrıntılı bilgi getirir.
• get-request-body: Belirli bir uç nokta ve HTTP metodu için istek gövdesi şemasını sağlar.
• get-response-schema: Belirli bir uç nokta, metod ve durum kodu için yanıt şemasını döndürür.
• get-path-parameters: Belirli bir yol için parametreleri getirir.
• list-components: Tüm şema bileşenlerini (şemalar, yanıtlar, parametreler vb.) listeler.
• get-component: Belirli bir bileşenin ayrıntılı tanımını döndürür.
• list-security-schemes: API’deki mevcut tüm güvenlik şemalarını listeler.
• get-examples: Belirli bir bileşen veya uç nokta için örnekleri getirir.
• search-schema: OpenAPI spesifikasyonu içindeki yollar, işlemler ve şemalar arasında arama yapar.

Bu MCP Sunucusunun Kullanım Alanları

• API Keşfi ve Dokümantasyonu: Geliştiriciler veya LLM’ler uç noktaları, parametreleri ve şemaları hızlıca listeleyerek bir API’nin yapısını dokümante etmeyi veya anlamayı kolaylaştırır.
• Otomatik Kod Üretimi: İstek ve yanıt şemalarını programatik olarak alarak araçların API etkileşimi için istemci kütüphaneleri veya kod parçacıkları üretmesine olanak tanır.
• API Testi ve Doğrulama: Test araçları, parametreleri ve örnek yükleri almak için bu sunucuyu kullanarak otomatik veya manuel API testini destekler.
• Güvenlik İncelemesi: Mevcut güvenlik şemalarını ve uç noktalar üzerindeki uygulamalarını analiz ederek API’lerin doğru şekilde korunduğundan emin olun.
• Şema Arama ve Analizi: Büyük API spesifikasyonlarında belirli bir varlık veya özellikle ilgili şema bileşenlerini veya uç noktalarını hızlıca bulun ve analiz edin.

Kurulum nasıl yapılır

Windsurf

Windsurf için kurulum talimatı verilmemiştir.

Claude

1. Node.js ve npx kurulu olduğundan emin olun.
2. Claude Masaüstü yapılandırma dosyanızı bulun:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. mcpServers nesnesi altında OpenAPI Şeması MCP sunucusunu ekleyin:

   {
     "mcpServers": {
       "OpenAPI Schema": {
         "command": "npx",
         "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"]
       }
     }
   }
   

4. Dosyayı kaydedin ve Claude Masaüstünü yeniden başlatın.
5. Sunucunun Claude arayüzünüzde kullanılabilir olduğunu doğrulayın.

Cursor

Cursor için kurulum talimatı verilmemiştir.

Cline

Claude Code CLI

1. Node.js ve npx kurulu olduğundan emin olun.
2. OpenAPI Şeması MCP sunucusunu ekleyin:

   claude mcp add openapi-schema npx -y mcp-openapi-schema
   

   Ya da belirli bir şema dosyası ile:

   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

3. Kaydı doğrulayın:

   claude mcp list
   claude mcp get openapi-schema
   

4. İsteğe bağlı olarak sunucuyu kaldırın:

   claude mcp remove openapi-schema
   

5. Araçları Claude Code oturumunuzda kullanın.

API Anahtarlarını Güvenceye Alma

API anahtarlarını güvenli hale getirmek ya da ortam değişkenleri kullanımıyla ilgili bilgi verilmemiştir.

Bu MCP nasıl akışlara entegre edilir

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, akışınıza MCP bileşenini ekleyin ve onu yapay zeka ajanınıza bağlayın:

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

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

Yapılandırıldıktan sonra, yapay zeka ajanı artık tüm işlev ve yeteneklerine erişerek bu MCP’yi bir araç olarak kullanabilir. “MCP-name” kısmını gerçek MCP sunucunuzun adıyla (ör. “github-mcp”, “weather-api” vb.) ve URL’yi kendi MCP sunucu adresiniz ile değiştirmeyi unutmayın.

Genel Bakış

Mevcut dokümantasyona göre, OpenAPI Şeması MCP Sunucusu LLM’lerle OpenAPI keşfi için oldukça özelleşmiş ve güçlü bir araç seti sunuyor; ancak istemler, kaynaklar, API anahtarı yönetimi ve gelişmiş MCP özellikleri konusunda detaydan yoksun. OpenAPI kullanım senaryoları için güçlü; daha geniş MCP özellikleri için ise sınırlı.

MCP Puanı

Puan:
Bu MCP sunucusuna 6/10 puan veriyorum. OpenAPI şeması keşfi için iyi tanımlanmış ve güçlü bir araç seti sunmasına rağmen, MCP istem şablonları, açık kaynak tanımları, güvenlik en iyi uygulamaları ve kök ya da örnekleme desteğiyle ilgili dokümantasyon eksikliği var. Ayrıca, bir LİSANS’ın olmaması açık iş birliği için önemli bir sınırlama.