Herhangi Bir OpenAPI MCP Sunucusu

“Herhangi Bir OpenAPI” MCP Sunucusu ne işe yarar?

“Herhangi Bir OpenAPI” MCP Sunucusu, Claude gibi AI asistanlarını bir OpenAPI (Swagger) spesifikasyonunu sunan herhangi bir harici API’ye bağlamak için tasarlanmış bir araçtır. Büyük OpenAPI belgelerinde anlamsal arama yaparak uç noktaları akıllıca böler ve hızlıca keşfetmenizi ve etkileşime geçmenizi sağlar. Bu sayede AI istemcileri, doğal dil sorguları (ör. “ürünleri listele”) ile ilgili API uç noktalarını bulabilir, uç nokta belgelerinin tamamına anında erişebilir ve API isteklerini doğrudan sunucudan çalıştırabilir. Sunucu, özel veya büyük API’leri AI destekli iş akışlarına entegre etmek için idealdir; veritabanı sorguları veya özel API entegrasyonları gibi işlemleri sık sık elle güncelleme gerektirmeden kolaylaştırır.

Prompt Listesi

Mevcut dokümantasyon veya kodda belirli bir prompt şablonu belirtilmemiştir.

Kaynak Listesi

Mevcut dokümantasyon veya kodda açıkça belirtilmiş bir MCP kaynağı bulunmamaktadır.

Araçlar Listesi

• custom_api_request_schema
  OpenAPI spesifikasyonu üzerinde anlamsal arama gerçekleştirerek ilgili API uç noktalarını keşfedin. Bu araç, doğal dil sorgularına göre uç nokta dokümantasyon parçalarını sunar.
• custom_make_request
  Seçilen uç noktaya karşı bir API isteği çalıştırın. AI asistanının API ile doğrudan etkileşime geçmesini, istek göndermesini ve yanıt almasını sağlar.

Bu MCP Sunucusunun Kullanım Senaryoları

• Özel Servisler için API Entegrasyonu
  Claude veya diğer asistanları, OpenAPI JSON URL’si sağlayarak özel API’lere sorunsuzca bağlayın ve dahili sistemlerle güvenli ve dinamik etkileşim sağlayın.
• Hızlı Uç Nokta Keşfi
  Bellek içi anlamsal arama (FAISS ve MiniLM-L3 ile güçlendirilmiş) ile büyük ve karmaşık OpenAPI belgelerinde bile ilgili API uç noktalarını hızla bulun.
• Otomatik API İsteği Yürütme
  AI istemcilerinin yalnızca uç noktaları keşfetmesini değil, aynı zamanda API isteklerini yürütmesini sağlayarak ürün listeleme, sipariş yönetimi veya kullanıcı sorgulama gibi iş akışlarını ek bir araca gerek olmadan etkinleştirin.
• Bağlamsal API Dokümantasyonuna Erişim
  Uç nokta bazlı dokümantasyonu anında alın, AI destekli otomasyon için ayrıntılı parametre keşfi ve kullanımı sağlayın.
• Claude Desktop veya Benzeri İstemcilerle Entegrasyon
  Claude’un MCP istemcisiyle çalışacak şekilde tasarlanmıştır, belge boyutu sınırlarını aşar ve masaüstü AI uygulamaları için büyük API’lerin pratik kullanımını mümkün kılar.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js ve Windsurf’ün kurulu olduğundan emin olun.
2. Windsurf yapılandırma dosyanızı bulun.
3. @any-openapi/mcp-server@latest girdisini mcpServers nesnesine ekleyin.
4. Komutu ve gerekli ortam değişkenlerini sağlayın (örneğin OPENAPI_JSON_DOCS_URL).
5. Kaydedin ve Windsurf’ü yeniden başlatın, ardından sunucunun beklendiği gibi görünüp görünmediğini doğrulayın.

Örnek JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API Anahtarlarını Güvenceye Alma:

{
  "env": {
    "API_KEY": "${ANY_OPENAPI_API_KEY}"
  },
  "inputs": {
    "apiKey": "${ANY_OPENAPI_API_KEY}"
  }
}

Claude

1. Claude’un MCP sunucu entegrasyonunu desteklediğinden emin olun.
2. MCP sunucuları için ayar veya yapılandırma panelini açın.
3. Komut ve ortam değişkenleri ile sunucu ayrıntılarını girin.
4. Değişiklikleri kaydedin ve gerekirse Claude’u yeniden başlatın.
5. Sunucunun keşfedilebilir ve aktif olduğunu doğrulayın.

Örnek JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cursor

1. Cursor’u yükleyin ve MCP sunucu yapılandırma bölümüne gidin.
2. @any-openapi/mcp-server@latest paketini kullanarak yeni bir MCP sunucu girdisi ekleyin.
3. API’niz için gerekli ortam değişkenlerini ayarlayın.
4. Yapılandırmayı kaydedin ve Cursor’u yeniden başlatın.
5. Mevcut araçları listeleyerek entegrasyonu doğrulayın.

Örnek JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cline

1. Cline yapılandırma dosyanızı açın.
2. @any-openapi/mcp-server@latest için MCP sunucu yapılandırmasını ekleyin.
3. Gerekli ortam değişkenlerini ayarlayın.
4. Kaydedin ve Cline’ı yeniden başlatın.
5. Sunucunun aktif MCP sunucuları arasında listelendiğinden emin olun.

Örnek JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

API Anahtarlarını Güvenceye Alma:
Hassas kimlik bilgilerini ifşa etmemek için yukarıdaki gibi ortam değişkenlerini kullanın.

Bu MCP’nin Akışlarda Kullanımı

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, akışa 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 ayrıntılarınızı şu JSON formatında girin:

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

Yapılandırıldıktan sonra, AI ajanı bu MCP’yi tüm işlevlerine ve yeteneklerine erişebilen bir araç olarak kullanabilir. “any-openapi” ismini gerçek MCP sunucunuzun adıyla ve URL’yi doğru uç nokta ile değiştirmeniz gerektiğini unutmayın.

Genel Bakış

Roots desteği: Mevcut dokümantasyon veya kodda belirtilmemiştir.

Sağlanan dokümantasyon ve yukarıdaki özet temelinde, bu MCP sunucusu odaklı, işlevsel ve API entegrasyonu ile dinamik uç nokta keşfi için çok uygundur; ancak açık örnek prompt/kaynaklar ve örnekleme veya roots hakkında dokümantasyon eksiktir. Kurulumu ve güvenlik uygulamaları nettir ve standarttır.

Bizim görüşümüz

Bu MCP sunucusu, özellikle Claude ile büyük veya özel API’leri AI asistanlarıyla entegre etmesi gereken geliştiriciler için oldukça pratiktir. Anlamsal uç nokta keşfi ve doğrudan API yürütmesi açısından güçlü bir faydası vardır, ancak daha fazla dokümantasyon ve kaynak tanımı faydalı olurdu. Genel olarak, sağlam ve odaklanmış bir sunucu, ancak tüm MCP özelliklerinin tam kapsamlı bir örneği değildir.

Puan: 7/10

MCP Puanı