OpenAPI Şema Gezgini MCP Sunucusu

“OpenAPI Şema Gezgini” MCP Sunucusu ne yapar?

OpenAPI Şema Gezgini MCP Sunucusu, OpenAPI/Swagger spesifikasyonlarına MCP Kaynakları aracılığıyla token-verimli erişim sağlar ve istemci tarafında API şemalarının keşfedilmesini mümkün kılar. Bu sunucu, AI asistanları ile harici API dokümantasyonu arasında bir köprü görevi görerek araçların ve Büyük Dil Modellerinin (LLM’ler) API spesifikasyonlarını programatik olarak sorgulamasına, okumasına ve analiz etmesine olanak tanır. OpenAPI/Swagger spesifikasyonlarını yapılandırılmış kaynaklar olarak sunarak endpoint keşfi, parametre incelemesi ve şema doğrulama gibi görevleri kolaylaştırır; üçüncü taraf API’lerle entegrasyon veya bu API’ler üzerinde geliştirme yapan ekiplerin iş akışını iyileştirir. Bu sunucu, özellikle API dokümantasyonunu analiz etmeyi otomatikleştirmek, kod üretimini geliştirmek veya entegrasyon noktalarını ölçeklenebilir ve standart bir şekilde doğrulamak isteyen geliştiriciler ve AI ajanları için kullanışlıdır.

Prompt Listesi

Mevcut depo dosyalarında veya dökümantasyonda açıkça tanımlanmış prompt şablonları bulunmamaktadır.

Kaynak Listesi

• OpenAPI/Swagger Spesifikasyonları
  OpenAPI ve Swagger spesifikasyon belgelerini, verimli alma ve keşif için yapılandırılmış MCP Kaynakları olarak sunar.
• API Endpointleri
  Belirli bir OpenAPI/Swagger spesifikasyonu içindeki tüm mevcut endpoint’lerin kolayca listelenebilmesi ve seçilebilmesi için kaynak görünümü sağlar.
• Şema Tanımlamaları
  API spesifikasyonu içindeki şema tanımlarına ve bileşenlere erişim sağlar; doğrulama ve tip kontrolü görevlerini destekler.

Araç Listesi

Depoda server.py veya eşdeğer giriş noktası dosyalarında açıkça tanımlanmış araçlar bulunmamaktadır.

Bu MCP Sunucusunun Kullanım Alanları

• API Dokümantasyonu Keşfi
  AI asistanlarının ve geliştiricilerin OpenAPI/Swagger dokümantasyonunu programatik olarak keşfetmesini ve gezinmesini sağlar, onboarding ve otomasyonu iyileştirir.
• Endpoint Keşfi
  Hedef API’deki mevcut endpoint’lerin hızlıca tespit edilmesini ve listelenmesini sağlar; hızlı prototipleme ve entegrasyonu destekler.
• Şema Doğrulama
  İstek ve yanıt şemalarının otomatik olarak doğrulanmasını kolaylaştırır; uyumluluğu sağlar ve entegrasyon hatalarını azaltır.
• Kod Üretim Desteği
  Şartname detaylarına yapılandırılmış erişim sağlar; OpenAPI tanımlarından istemci kodu veya iskeletler otomatik olarak üreten araçlara yardımcı olur.
• Otomatik Test Kurulumu
  API isteklerini oluşturmak için gerekli şema ve parametreleri açığa çıkararak test senaryoları veya mock veri elde edilmesine yardımcı olur.

Kurulum Nasıl Yapılır

Windsurf

1. Gerekli önkoşulların yüklü olduğundan emin olun (örn. Node.js, gerekiyorsa Docker).
2. Windsurf yapılandırma dosyasını bulun (genellikle windsurf.config.json).
3. Aşağıdaki JSON parçasını kullanarak OpenAPI Şema Gezgini MCP Sunucusunu ekleyin:

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. Yapılandırmanızı kaydedin ve Windsurf’u yeniden başlatın.
5. Sunucunun çalıştığını ve istemcinizden erişilebilir olduğunu doğrulayın.

API Anahtarlarını Güvenli Hale Getirme:

{
  "mcpServers": {
    "openapi-schema-explorer": {
      "env": {
        "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
      },
      "inputs": {
        "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
      }
    }
  }
}

Claude

1. Gerekli bağımlılıkları yükleyin (Node.js vb.).
2. Claude platformunun MCP yapılandırma dosyasını düzenleyin.
3. mcpServers bölümüne aşağıdaki JSON’u ekleyin:

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. Yapılandırmayı kaydedin ve Claude’u yeniden başlatın.
5. MCP sunucusunun mevcut entegrasyonlar arasında listelendiğini doğrulayın.

API Anahtarlarını Güvenli Hale Getirme:

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

Cursor

1. Node.js ve diğer önkoşulların kurulu olduğunu doğrulayın.
2. Cursor platformunun ayarlarını veya yapılandırma dosyasını açın.
3. MCP sunucusunu şu şekilde ekleyin:

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. Kaydedin ve Cursor’u yeniden yükleyin.
5. Mevcut sunucuları listeleyerek entegrasyonu kontrol edin.

API Anahtarlarını Güvenli Hale Getirme:

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

Cline

1. Tüm önkoşulların (Node.js vb.) yüklü olduğundan emin olun.
2. Cline yapılandırma dosyasını bulun ve açın.
3. Sunucuyu etkinleştirmek için bu JSON’u ekleyin:

   {
     "mcpServers": {
       "openapi-schema-explorer": {
         "command": "npx",
         "args": ["@kadykov/mcp-openapi-schema-explorer@latest"]
       }
     }
   }
   

4. Dosyayı kaydedin ve Cline’ı yeniden başlatın.
5. MCP sunucusunun ortamınızda göründüğünü doğrulayın.

API Anahtarlarını Güvenli Hale Getirme:

{
  "env": {
    "API_KEY": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  },
  "inputs": {
    "api_key": "${OPENAPI_SCHEMA_EXPLORER_API_KEY}"
  }
}

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, iş akışınıza MCP bileşenini ekleyin ve AI 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üne, MCP sunucu detaylarınızı şu JSON formatında girin:

{
  "openapi-schema-explorer": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırıldıktan sonra, AI ajanı bu MCP’yi tüm işlev ve yetenekleriyle bir araç olarak kullanabilir. “openapi-schema-explorer” ifadesini kendi MCP sunucunuzun gerçek adıyla ve URL’yi de kendi sunucu adresiniz ile değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Yukarıdakilere göre, OpenAPI Şema Gezgini MCP faydalı dokümantasyon ve kurulum sunar, ancak açıkça tanımlanmış prompt ve araç tanımları eksiktir; bu da kutudan çıktığı haliyle ajan tabanlı çok yönlülüğünü sınırlar. Güçlü bir kaynak odaklı MCP’dir fakat ileri düzey kullanım için ek geliştirme veya dokümantasyon gerekebilir.
Puan: 6/10

MCP Puanı