MCP Hub

Model Context Protocol (MCP) sunucu dizini. GitHub, resmi registry ve awesome listelerinden MCP sunucularını toplar, kategorize eder ve tek bir dashboard'da gösterir.

Özellikler

• 3 Kaynak: GitHub topic search, modelcontextprotocol/servers resmi registry, awesome-mcp-servers listeleri
• Otomatik Kategorizasyon: database, filesystem, api, search, ai-tools, productivity, other
• Velocity Score: yıldız + fork + son commit aktivitesi bazlı hız skoru
• Türkçe UI: dark theme, kart & tablo görünümü
• Cron: Her 4 saatte otomatik refresh
• Basic Auth: tüm endpointler korumalı (/health hariç)

Kurulum

cp .env.example .env
# .env içinde ADMIN_PASS ve opsiyonel GITHUB_TOKEN ayarla
npm install
npm start

Uygulama http://localhost:4701/mcp-hub adresinde çalışır.

Konfigürasyon

| Değişken | Açıklama | Varsayılan |
|----------------|---------------------------------------|-----------------------|
| PORT | Sunucu portu | 4701 |
| ADMIN_PASS | Basic Auth şifresi (zorunlu) | admin |
| GITHUB_TOKEN | GitHub PAT (rate limit artırımı) | boş (60 req/saat) |
| DB_PATH | SQLite veritabanı yolu | ./data/mcp-hub.db |

API Endpointleri

GET  /mcp-hub/health                          # Auth-free sağlık kontrolü
GET  /mcp-hub/api/servers?category=&q=&sort= # Sunucu listesi
GET  /mcp-hub/api/servers/:id                # Sunucu detayı
GET  /mcp-hub/api/stats                      # İstatistikler
GET  /mcp-hub/api/categories                 # Kategori listesi
GET  /mcp-hub/api/trending?window=7d         # Trend sunucular
POST /mcp-hub/api/refresh                    # Manuel refresh

/api/servers Parametreleri

| Parametre | Açıklama |
|--------------|--------------------------------------------------|
| category | Filtre: database, filesystem, api, search, vb. |
| q | Metin araması (isim, açıklama) |
| min_stars | Minimum yıldız sayısı |
| sort | velocity_score, stars, last_commit_at, vb. |
| page | Sayfa numarası (varsayılan: 1) |
| limit | Sayfa başı kayıt (varsayılan: 24, max: 100) |

Velocity Score

score = (stars × 0.5) + (recent_commits_30d × 10) + (forks × 2)
      + (official_registry ? 100 : 0) + (topic_mcp ? 20 : 0)

Son 30 günde commit yoksa: score × 0.3
```

Geliştirme

node --watch server.js   # Otomatik yeniden başlatma (Node 18+)