OpenAPI MCP Sunucusu

“OpenAPI” MCP Sunucusu ne yapar?

OpenAPI MCP Sunucusu, AI asistanlarını (ör. Claude ve Cursor) oapis.org üzerinden OpenAPI spesifikasyonlarını arama ve keşfetme yeteneğiyle buluşturmak için tasarlanmış bir Model Context Protocol (MCP) sunucusudur. Bir köprü görevi görerek, AI modellerinin karmaşık API’leri basit bir dille kapsamlı şekilde anlamasını sağlar. Sunucu üç aşamalı bir süreç izler: Gerekli OpenAPI spesifikasyonunu tespit etmek, erişilebilir terimlerle özetlemek ve uç noktaları ile kullanım detaylarını aktarmak. Kimlik doğrulama kısıtları nedeniyle API uç noktalarını doğrudan çalıştırmasa da, API genel bakışları sağlama, kod üretimi kolaylaştırma ve API yapısının anlaşılması ile dokümantasyonu gereken geliştirme akışlarını destekleme konularında oldukça başarılıdır.

Komut Listesi

• Genel Bakış Komutu: Bir OpenAPI spesifikasyonunun özetini ve anlaşılmasını ister.
• İşlem Detayları Komutu: Belirli API işlemlerinin detaylı açıklamalarını getirir.
• Uç Nokta Belirleme Komutu: Bir sorguya göre hangi uç noktaların ilgili olduğunu tespit eder.

Kaynak Listesi

• OpenAPI Spesifikasyonu Genel Bakış: Tüm API spesifikasyonlarının özetini sağlar.
• API İşlem Detayları: Belirli uç noktalar ve parametreleri hakkında bağlamsal bilgiler sunar.
• Format Esnekliği: Hem JSON hem de YAML formatındaki API spesifikasyonlarını destekler.
• Uyumluluk Kaynağı: Claude Desktop ve Cursor ile test edilmiş kaynaklarla sorunsuz bağlam iletimi.

Araç Listesi

• v2’de çalıştırılabilir araçlar sunulmaz; sunucu API’leri hakkında keşif ve bağlam sağlamaya odaklanır, uç noktaların doğrudan çalıştırılmasına izin vermez.

Bu MCP Sunucusunun Kullanım Alanları

• API Dokümantasyonu Üretimi: Karmaşık OpenAPI spesifikasyonlarından insan tarafından okunabilir dokümantasyonu otomatik olarak oluşturun, API’leri geliştiriciler için daha anlaşılır kılın.
• API Kod Üretim Desteği: Açık uç nokta açıklamaları ve kullanım detayları sunarak geliştiricilere istemci kodu üretiminde yardımcı olun.
• API Keşfi ve Araştırması: Mevcut uç noktaları hızlıca tespit edip özetleyin, ekiplerin veya AI modellerinin API yeteneklerini keşfetmesine yardımcı olun.
• AI Ajanları için Bağlam Sağlama: LLM’lere veya ajanlara ilgili API bağlamını sunarak, harici API’lerle ilgili soruları yanıtlamalarını veya kod yazmalarını geliştirin.
• Oryantasyon ve Eğitim: Yeni ekip üyelerinin veya AI ajanlarının, basitleştirilmiş özetler ve işlem dökümleriyle tanımadıkları API’leri öğrenmesine yardımcı olun.

Kurulum Nasıl Yapılır

Windsurf

1. Sisteminizde Node.js’in kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyanızı açın.
3. Sağlanan JSON parçasını kullanarak OpenAPI MCP Sunucusunu mcpServers bölümüne ekleyin.
4. Yapılandırmayı kaydedin ve Windsurf’u yeniden başlatın.
5. MCP sunucusuna bağlantıyı doğrulayın.

Örnek yapılandırma:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

Not: API anahtarlarınızı yukarıda gösterildiği gibi ortam değişkenleriyle güvenceye alın.

Claude

1. Node.js’i kurun.
2. Claude’un MCP entegrasyon ayarlarına erişin.
3. Aşağıdaki yapılandırmayla OpenAPI MCP sunucusunu ekleyin.
4. Ayarları kaydedin ve Claude’u yeniden başlatın.
5. Sunucunun MCP kaynağı olarak kullanılabilir olduğundan emin olun.

Örnek yapılandırma:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

Cursor

1. Node.js’in kurulu olduğundan emin olun.
2. Cursor’ın yapılandırma dosyasını bulun.
3. OpenAPI MCP sunucusunu mcpServers altına ekleyin.
4. Kaydedin ve Cursor’u yeniden başlatın.
5. Örnek bir OpenAPI sorgusuyla test edin.

Örnek yapılandırma:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

Cline

1. Node.js yüklü değilse yükleyin.
2. Cline yapılandırma dosyasını düzenleyerek OpenAPI MCP’yi ekleyin.
3. Aşağıdaki JSON bloğunu ekleyin.
4. Değişiklikleri kaydedin ve Cline’ı yeniden başlatın.
5. MCP sunucusunun aktif olduğunu doğrulayın.

Örnek yapılandırma:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

API Anahtarlarını Güvenceye Alma:
Hassas anahtarlarınızı ortam değişkenlerinde saklayın ve yapılandırmada env özelliğiyle referans verin.

Bu MCP Nasıl Akışlarda Kullanılır

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 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üne aşağıdaki JSON formatında MCP sunucu detaylarınızı girin:

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

Yapılandırma tamamlandığında, AI ajanınız bu MCP’yi bir araç olarak tüm işlevlerine ve yeteneklerine erişebilir şekilde kullanabilir. “openapi-mcp” adını kendi MCP sunucunuzun adıyla ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Bizim Görüşümüz

OpenAPI MCP Sunucusu, OpenAPI spesifikasyonları için bağlam ve keşif araçları sağlama konusunda odaklı ve faydalı bir MCP’dir. Uç nokta çalıştırma eksikliği bazı ileri kullanım durumları için bir sınırlamadır ve örnekleme/kök desteği belgelenmemiştir. Ancak, net kurulum talimatları, güçlü kod temeli ve toplulukta aktif kullanımıyla, API bağlamı ve kod üretim desteğine ihtiyaç duyan geliştiriciler için güçlü bir seçenektir.

MCP Puanı