plugged.in MCP Hub — Proxy · Knowledge · Memory · Tools

📋 Genel Bakış

plugged.in MCP Proxy Server, birden fazla Model Context Protocol (MCP) sunucusunu tek bir birleştirilmiş arayüze toplayan güçlü bir ara yazılımdır. plugged.in App öğesinden tool, prompt ve resource konfigürasyonlarını alır ve istekleri uygun temel MCP sunucularına akıllıca yönlendirir.

Bu proxy, herhangi bir MCP istemcisine (Claude, Cline, Cursor, vb.) sorunsuz entegrasyon sağlarken, plugged.in ekosistemi aracılığıyla gelişmiş yönetim yetenekleri sunar.

Hub Ayakları: Knowledge · Memory · Tools · Proxy

Knowledge (RAG v2 / AI Dokumen Alışverişi)
Model çıktılarını birleştirilmiş, atıf ile ilişkili dokumen retrieval ile arayın ve temellendirin. MCP sunucuları, versiyon oluşturma, görünürlük kontrolleri ve model atıflandırması ile birlikte kütüphanenizde belgeler oluşturabilir ve yönetebilir. Tüm bağlı kaynaklarda arama yapmak ve ilgili snippet'ler ile metadata döndürmek için yerleşik RAG'ı kullanın.

Memory (Kalıcı AI Belleği)
Oturumları sürdüren, workspace/profil kapsamında uzun süreli bellek. Hub, plugged.in App'in kalıcı belleğiyle integre olarak agent eylemlerinin ve içgörülerinin görevler arasında depolanması ve hatırlanması sağlanır. Düşük maliyetli get/put/search modellerini aynı kimlik doğrulama modeli altında ortaya koyan yerleşik bellek araçları yol haritasında yer almaktadır.

Tools
Yerleşik yetenekleri aşağı yöndeki MCP sunucuları (STDIO, SSE, Streamable HTTP) ile toplayın. Tool keşfi önbelleğe alınır ve talep üzerine yenilenebilir; hub seviyesi keşfi, herhangi bir MCP istemcisi için birleştirilmiş bir katalog döndürür. Hub, tools, resources, resource templates ve prompts'u destekler.

Proxy
Her istemci için bir bağlantı. STDIO (varsayılan) veya isteğe bağlı API auth ve stateless moduyla Streamable HTTP olarak çalıştırın. Claude Desktop, Cline, Cursor, MCP Inspector ve daha fazlasıyla çalışır; mevcut istemci konfigürasyonlarınızı tutarken politikaları ve telemetriyi merkezi konuma alın.

⭐ Bu projeyi faydalı bulursanız, lütfen GitHub'da bir yıldız vermeyi düşünün! Bu, daha fazla geliştiriciye ulaşmamıza ve iyileştirmeye devam etmemizi motive eder.

✨ Temel Özellikler

🚀 Çekirdek Yetenekler

• Yerleşik AI Oyun Alanı: Herhangi bir istemci kurulumu olmadan MCPs'inizi Claude, Gemini, OpenAI ve xAI ile anında test edin
• Evrensel MCP Uyumluluğu: Claude Desktop, Cline ve Cursor dahil herhangi bir MCP istemcisiyle çalışır
• Multi-Server Desteği: STDIO, SSE ve Streamable HTTP MCP sunucularına bağlanın
• Dual Transport Modları: Proxy'yi STDIO (varsayılan) veya Streamable HTTP sunucusu olarak çalıştırın
• Birleştirilmiş Belge Arama: Yerleşik RAG yetenekleriyle tüm bağlı sunucularda arama yapın
• AI Dokumen Alışverişi (RAG v2): MCP sunucuları tam atıflandırmayla kütüphanenizde belgeler oluşturabilir ve yönetebilir
• Herhangi bir Modelden Bildirimler: İsteğe bağlı e-posta teslimi ile gerçek zamanlı bildirimler alın
• Multi-Workspace Katmanı: Bir tıkla farklı MCP konfigürasyonu setleri arasında geçiş yapın
• API-Güdümlü Proxy: Doğrudan keşif yerine plugged.in App API'lerinden yetenekler alır
• Tam MCP Desteği: Tools, resources, resource templates ve prompts'u işler
• Özel Talimatlar: MCP prompts olarak biçimlendirilmiş sunucu özel talimatlarını destekler

🎯 v1.5.0'da Yeni (RAG v2 - AI Dokumen Alışverişi)

• AI Dokumen Oluşturma: MCP sunucuları artık doğrudan kütüphanenizde belgeler oluşturabilir
  • Tam model atıflandırma izlemesi (hangi AI'nin belgeyi oluşturduğu/güncelleştirdiği)
  • Değişim izlemeli sürüm geçmişi
  • SHA-256 hashing yoluyla içerik çoğaltma kaldırma
  • Çoklu format desteği: MD, TXT, JSON, HTML, PDF ve daha fazlası
• Gelişmiş Belge Arama: AI filtreleme ile geliştirilmiş RAG sorguları
  • AI modeli, sağlayıcı, tarih aralığı, etiketler ve kaynak türüne göre filtrele
  • İlgili puanlama ile anlamsal arama
  • Anahtar kelime vurgulaması ile otomatik snippet oluşturma
  • Filtreleme desteği: ai_generated, upload veya api kaynakları
• MCP Aracılığıyla Belge Yönetimi:
  • Belge görünürlüğünü ayarla: özel, workspace veya halka açık
  • Belge sürümleri için üst-alt ilişkileri
  • Proje tabanlı kapsamın yanında profil tabanlı organizasyon
  • Belge işleme için gerçek zamanlı ilerleme izlemesi

🎯 v1.4.0'dan Özellikler (Registry v2 Desteği)

• OAuth Token Yönetimi: Streamable HTTP MCP sunucuları için sorunsuz OAuth kimlik doğrulaması
  • plugged.in App'den otomatik token alımı
  • Güvenli token depolaması ve yenileme mekanizmaları
  • İstemci tarafı kimlik doğrulaması gerekmez
• Geliştirilmiş Bildirim Sistemi: Çift yönlü bildirim desteği
  • plugged.in App'e bildirimler gönder
  • MCP sunucularından bildirimler al
  • Bildirimleri okundu/okunmadı olarak işaretle
  • Bildirimleri programlı olarak sil
• Trending Analitikler: Gerçek zamanlı aktivite izlemesi
  • Her tool çağrısı kaydedilir ve izlenir
  • Trending server hesaplamalarına katkıda bulun
  • Kullanım metrikleri ve popülarite içgörüleri
• Registry Entegrasyonu: Registry v2 özelliklerinin tam desteği
  • Kayıt defterinden otomatik server keşfi
  • Kurulum izlemesi ve metrikleri
  • Topluluk server desteği

📦 v1.1.0'dan Özellikler

• Streamable HTTP Desteği: Streamable HTTP transport kullanan aşağı yöndeki MCP sunucuları için tam destek
• HTTP Server Modu: Proxy'yi yapılandırılabilir portlarla bir HTTP sunucusu olarak çalıştırın
• Esnek Kimlik Doğrulama: HTTP endpoint'leri için isteğe bağlı Bearer token kimlik doğrulaması
• Oturum Yönetimi: Stateful (oturum tabanlı) veya stateless işlem modları arasında seçim yapın

🎯 v1.0.0'dan Çekirdek Özellikler

• Gerçek Zamanlı Bildirimler: Kapsamlı bildirim desteğiyle tüm MCP etkinliklerini izleyin
• RAG Entegrasyonu: plugged.in App aracılığıyla belge artırılmış sorgular için destek
• Inspector Betikleri: Hata ayıklama ve geliştirme için otomatik test araçları
• Sistem Durumu İzlemesi: Bağlantı izlemesi için yerleşik ping endpoint'i

🔧 Tool Kategorileri

Proxy iki farklı tool kategorisi sağlar:

🔧 Statik Yerleşik Araçlar (Her Zaman Kullanılabilir)

Bu araçlar proxy'ye yerleştirilmiştir ve herhangi bir sunucu konfigürasyonu olmadan çalışır:

• pluggedin_discover_tools - Anında sonuçlar için önbelleğe alınmış akıllı keşif
• pluggedin_ask_knowledge_base - AI filtreleme yetenekleriyle belgelerinizde RAG arama
• pluggedin_send_notification - İsteğe bağlı e-posta teslimi ile bildirimler gönder
• pluggedin_create_document - Kütüphanenizde AI tarafından oluşturulan belgeler oluştur
• pluggedin_list_documents - Filtreleme seçenekleriyle belgeleri listele
• pluggedin_search_documents - Sorguya göre belgeleri ara
• pluggedin_get_document - ID'ye göre belgenin tam içeriğini al
• pluggedin_update_document - Mevcut belgeyi güncelle veya ekle

📋 Pano Araçları (Bellek Sistemi)

• pluggedin_clipboard_set - İsme (anlamsal anahtar) veya indekse göre pano girişi ayarla
• pluggedin_clipboard_get - İsim, indeks veya tümü ile pano girişlerini al
• pluggedin_clipboard_delete - İsim, indeks veya tümü ile pano girişlerini sil
• pluggedin_clipboard_list - Metadata ile tüm pano girişlerini listele
• pluggedin_clipboard_push - Otomatik artırılan indeksle değer ekle (stack push)
• pluggedin_clipboard_pop - En yüksek indeksli girişi çıkar (LIFO davranışı)

⚡ Dinamik MCP Tools (Bağlı Sunuculardan)

Bu araçlar yapılandırılmış MCP sunucularından gelir ve açılıp kapatılabilir:

• Veritabanı araçları (PostgreSQL, SQLite, vb.)
• Dosya sistemi araçları
• API entegrasyon araçları
• Herhangi bir MCP sunucusundan özel araçlar

Keşif aracı her iki kategoriyi akıllıca gösterir, AI modellerine tüm mevcut yeteneklere anında erişim sağlar.

🚀 Keşif Aracı Kullanımı

# Hızlı keşif - önbelleğe alınmış verileri anında döndür
pluggedin_discover_tools()

# Zorlama yenileme - geçerli araçları göster + arka planda keşif çalıştır  
pluggedin_discover_tools({"force_refresh": true})

# Belirli sunucuyu keşfet
pluggedin_discover_tools({"server_uuid": "uuid-here"})

Örnek Yanıt:

## 🔧 Statik Yerleşik Araçlar (Her Zaman Kullanılabilir):
1. **pluggedin_discover_tools** - Önbelleğe alınmış akıllı keşif
2. **pluggedin_rag_query** - Belgeler arasında AI filtreleme ile RAG v2 arama  
3. **pluggedin_send_notification** - Bildirimler gönder
4. **pluggedin_create_document** - (Çok Yakında) AI tarafından oluşturulan belgeler oluştur

## ⚡ Dinamik MCP Tools (8) - Bağlı Sunuculardan:
1. **query** - Salt okunur SQL sorguları çalıştır
2. **generate_random_integer** - Güvenli rastgele tamsayılar oluştur
...

📋 Pano Kullanım Örnekleri

Pano sistemi AI iş akışları için kalıcı bellek sağlar:

# Adlandırılmış girişi saklama (mevcut ise güncelle)
pluggedin_clipboard_set({
  "name": "customer_context",
  "value": "{\"name\": \"John Doe\", \"account_id\": \"12345\"}",
  "contentType": "application/json"
})

# Sıralı pipelines için indeksli girişi saklama
pluggedin_clipboard_set({
  "idx": 0,
  "value": "First pipeline step result",
  "createdByTool": "data_processor"
})

# Stack'a ekle (otomatik artırılan indeks)
pluggedin_clipboard_push({
  "value": "Analysis result from step 1",
  "contentType": "text/plain"
})

# İsme göre belirli girişi al
pluggedin_clipboard_get({"name": "customer_context"})

# Stack'ten çıkar (LIFO - en yüksek indeksi döndür ve sil)
pluggedin_clipboard_pop()

# Metadata ile tüm girişleri listele
pluggedin_clipboard_list({"limit": 20})

# Belirli girişi sil
pluggedin_clipboard_delete({"name": "customer_context"})

# Tüm pano girişlerini temizle
pluggedin_clipboard_delete({"clearAll": true})

📚 RAG v2 Kullanım Örnekleri

Geliştirilmiş RAG v2 sistemi MCP sunucularının belgeleri oluşturmasına ve tam AI atıflandırması ile arama yapmasına olanak tanır:

# Belirli AI modelleri tarafından oluşturulan belgeleri ara
pluggedin_rag_query({
  "query": "system architecture",
  "filters": {
    "modelName": "Claude 3 Opus",
    "source": "ai_generated",
    "tags": ["technical"]
  }
})

# Tüm belge kaynakları arasında arama
pluggedin_rag_query({
  "query": "deployment guide",
  "filters": {
    "dateFrom": "2024-01-01",
    "visibility": "workspace"
  }
})

# Gelecek: AI tarafından oluşturulan belgeler oluştur (Çok Yakında)
pluggedin_create_document({
  "title": "Analysis Report",
  "content": "# Market Analysis\n\nDetailed findings...",
  "format": "md",
  "tags": ["analysis", "market"],
  "metadata": {
    "model": {
      "name": "Claude 3 Opus",
      "provider": "Anthropic"
    }
  }
})

🚀 Hızlı Başlangıç

Ön Koşullar

• Node.js 18+ (önerilen v20+)
• plugged.in App'den bir API anahtarı (plugged.in/api-keys adresinden alın)

Kurulum

# npx ile kur ve çalıştır (en son v1.0.0)
npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

🔄 v1.0.0'ye Yükseltme

Mevcut kurulumlar için, ayrıntılı yükseltme talimatları için Migration Guide sayfasına bakın.

# Hızlı yükseltme
npx -y @pluggedin/pluggedin-mcp-proxy@1.0.0 --pluggedin-api-key YOUR_API_KEY

MCP İstemcileri için Konfigürasyon

Claude Desktop

Claude Desktop konfigürasyonunuza aşağıdakileri ekleyin:

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/pluggedin-mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cline

Cline konfigürasyonunuza aşağıdakileri ekleyin:

{
  "mcpServers": {
    "pluggedin": {
      "command": "npx",
      "args": ["-y", "@pluggedin/pluggedin-mcp-proxy@latest"],
      "env": {
        "PLUGGEDIN_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Cursor için, ortam değişkenleri yerine komut satırı bağımsız değişkenlerini kullanabilirsiniz:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY

⚙️ Konfigürasyon Seçenekleri

Ortam Değişkenleri

Değişken	Açıklama	Gerekli	Varsayılan
PLUGGEDIN_API_KEY	plugged.in App'den API anahtarı	Evet	-
PLUGGEDIN_API_BASE_URL	plugged.in App için temel URL	Hayır	https://plugged.in

Komut Satırı Bağımsız Değişkenleri

Komut satırı bağımsız değişkenleri ortam değişkenlerinden daha fazla önceliğe sahiptir:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --pluggedin-api-key YOUR_API_KEY --pluggedin-api-base-url https://your-custom-url.com

Transport Seçenekleri

Seçenek	Açıklama	Varsayılan
--transport <type>	Transport türü: stdio veya streamable-http	stdio
--port <number>	Streamable HTTP sunucusu için port	12006
--stateless	Streamable HTTP için stateless modu etkinleştir	false
--require-api-auth	Streamable HTTP istekleri için API anahtarı iste	false

Seçeneklerin tam listesi için:

npx -y @pluggedin/pluggedin-mcp-proxy@latest --help

🌐 Streamable HTTP Modu

Proxy, STDIO yerine bir HTTP sunucusu olarak çalışabilir, web tabanlı erişim ve uzak bağlantılar sağlar.

Temel Kullanım

# Varsayılan portta (12006) HTTP sunucusu olarak çalıştır
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --pluggedin-api-key YOUR_API_KEY

# Özel port
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --port 8080 --pluggedin-api-key YOUR_API_KEY

# Kimlik doğrulaması gerekliyse
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --require-api-auth --pluggedin-api-key YOUR_API_KEY

# Stateless modu (istek başına yeni oturum)
npx -y @pluggedin/pluggedin-mcp-proxy@latest --transport streamable-http --stateless --pluggedin-api-key YOUR_API_KEY

HTTP Endpoint'leri

• POST /mcp - MCP mesajları gönder
• GET /mcp - Server-sent events akışı (isteğe bağlı)
• DELETE /mcp - Oturumu sonlandır
• GET /health - Sistem durumu kontrol endpoint'i

Oturum Yönetimi

Stateful modda (varsayılan), oturumları sürdürmek için mcp-session-id başlığını kullanın:

# İlk istek bir oturum oluşturur
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Sonraki istekler aynı oturumu kullanır
curl -X POST http://localhost:12006/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: YOUR_SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"tool_name"},"id":2}'

Kimlik Doğrulama

--require-api-auth kullanırken, API anahtarınızı Bearer token olarak ekleyin:

curl -X POST http://localhost:12006/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"ping","id":1}'

🐳 Docker Kullanımı

Proxy sunucusunu Docker kullanarak oluşturabilir ve çalıştırabilirsiniz.

İmajı Oluşturma

Docker'ın kurulu ve çalışır durumda olduğundan emin olun. pluggedin-mcp dizinine gidin ve şunu çalıştırın:

docker build -t pluggedin-mcp-proxy:latest .

.dockerignore dosyası yapı bağlamını optimize etmek için bulunmaktadır.

Konteyneri Çalıştırma

STDIO Modu (Varsayılan)

Konteyneri MCP Inspector testi için STDIO modunda çalıştırın:

docker run -it --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \
  --name pluggedin-mcp-container \
  pluggedin-mcp-proxy:latest

Streamable HTTP Modu

Konteyneri HTTP sunucusu olarak çalıştırın:

docker run -d --rm \
  -e PLUGGEDIN_API_KEY="YOUR_API_KEY" \
  -e PLUGGEDIN_API_BASE_URL="YOUR_API_BASE_URL" \
  -p 12006:12006 \
  --name pluggedin-mcp-http \
  pluggedin-mcp-proxy:latest \
  --transport streamable-http --port 12006

YOUR_API_KEY ve YOUR_API_BASE_URL yerine (varsayılan https://plugged.in değerini kullanmıyorsanız) gerçek değerleri yazın.

MCP Inspector ile Test Etme

Konteyner çalışırken, MCP Inspector'ı kullanarak bağlanabilirsiniz:

npx @modelcontextprotocol/inspector docker://pluggedin-mcp-container

Bu, çalışan konteynerin standart girdi/çıktısına bağlanır.

Konteyneri Durdurma

docker run komutunun çalıştığı terminalde Ctrl+C tuşlarına basın. --rm bayrağı, durdurulduktan sonra konteynerin otomatik olarak kaldırılmasını sağlar.

☁️ Smithery Cloud Dağıtımı

plugged.in MCP Proxy'yi Smithery Cloud üzerine dağıtarak MCP sunucularınıza barındırılan, her zaman çevrimiçi erişim sağlayın.

Hızlı Başlangıç

1. smithery.ai adresini ziyaret edin ve oturum açın
2. GitHub hesabınızı bağlayın ve pluggedin-mcp deposunu seçin
3. Plugged.in API anahtarınızı Smithery UI'de yapılandırın
4. Dağıtın ve HTTPS endpoint'inizi alın

Avantajlar

• 24/7 Kullanılabilirlik: Proxy'niz her zaman çalışır
• Sıfır Konfigürasyon: Smithery, smithery.yaml dosyasından ayarları otomatik algılar
• Otomatik Ölçekleme: Birden fazla eşzamanlı bağlantıyı işleyin
• Web Erişimi: Web uygulamaları ve uzak istemciler için idealdir

Dokümantasyon

Tam dağıtım talimatları, konfigürasyon seçenekleri, sorun giderme ve teknik detaylar için bkz:

📖 Smithery Dağıtım Kılavuzu

Otonom Ajanlar (Ön İzleme)

Hub, uçtan uca agentic döngüleri desteklemek için tasarlanmıştır:

MCP İstemci  →  plugged.in MCP Hub  →  (Plan → Eyleme Geç → Yansıt)
                                ↘  Knowledge  ↘  Memory  ↘  Tools

• Plan — hedefleri ve kısıtlamaları türet, görev grafikleri oluştur.
• Eyleme Geç — birleştirilmiş katalogdan araçları çağır; STDIO/SSE/HTTP sunucuları arasında güvenli yönlendir