evren-mcp

Türkçe · English

EVREN Yapay Zeka Platformu'nu Claude Code'a bağlayan bir MCP sunucusu. "Bu veri setinde küçük bir model eğit, kaça mal olur?" dediğinde Claude maliyeti gösterir, onayını bekler, eğitimi başlatır, sonucu ve puan farkını getirir.

Farkı: kredi harcayan hiçbir iş, sana gösterilmiş ve senin onayladığın bir teklif olmadan başlamaz. Sunucu ayrıca kendi tek iş ve günlük kredi tavanını uygular.

Örnek

Sen:    Drone setimde küçük bir modeli ince ayarla. Kaça mal olur?
Claude: (list_datasets → estimate_training)
        Teklif T-51B553 — tahmini 0,54 CR, en kötü 1,82 CR.
        Bugün harcanan: 0 / 20 CR. Teklif 10 dk geçerli. Başlatayım mı?
Sen:    Evet.
Claude: (start_training T-51B553) Eğitim başladı: veri hazırlanıyor → eğitiliyor.
        …
Claude: (get_training) Tamamlandı. Gerçek maliyet 0,14 CR, mAP50 0,356,
        +15 puan.

Maliyet, metrik ve puan 06.10.2026'daki gerçek bir eğitimden; konuşma kısaltılmıştır.

Related MCP server: Kaggle-MCP

Gerekenler

• uv (uygun Python'u kendisi kurar; Python 3.11+)

• Claude Code ya da başka bir MCP istemcisi

• EVREN hesabı ve Platform API anahtarı (panel → API anahtarları → Platform)

Kurulum

1. Anahtarını yalnız senin okuyabileceğin bir dosyaya yaz, ör. ~/.evren-mcp/.env:

   EVREN_PLATFORM_API_KEY=platform-anahtarin

2. Sunucuyu Claude Code'a kaydet (dosyanın tam yolunu ver):

   claude mcp add evren --scope user -e EVREN_ENV_FILE=/tam/yol/.env \
     -- uvx --from git+https://github.com/emuzinun/evren-mcp evren-mcp
   claude mcp list   # evren … ✔ Connected

   Windows'ta C:/Users/sen/.evren-mcp/.env gibi bir yol kullan.

git clone https://github.com/emuzinun/evren-mcp.git && cd evren-mcp
uv sync
cp .env.example .env   # EVREN_PLATFORM_API_KEY'i doldur
claude mcp add evren --scope user -e EVREN_ENV_FILE=<tam-yol>/.env \
  -- uv run --directory <tam-yol> evren-mcp

Kurulumu denemek için Claude'a "evren diagnostics çağır" de: ayarlarını anahtar maskeli gösterir.

Araçlar

Hazır akışlar (Claude Code'da / menüsünde): egit — rehberli eğitim, durum — bakiye, puan ve süren eğitimler. Kaynaklar: evren://kurallar (kredi kazanç kuralları), evren://gunluk (yerel eğitim günlüğü).

Onay kapısı

estimate_training ──► teklif (ayar parmak izi, tahmini/en kötü tutar, 10 dk)
        │
   sen onaylarsın
        │
start_training(teklif) ──► teklif geçerli, kullanılmamış? ──► tek iş tavanı ──► günlük tavan ──► POST
                                  hayır → ret                  (en kötü durum)   (platform defteri, UTC günü)

1. Teklif tek kullanımlıktır ve 10 dakikada düşer; sunucu yeniden başlayınca teklifler silinir, eski bir fiyatla iş başlamaz.

2. Tek iş tavanı platformun en kötü durum tahminine göre denetlenir.

3. Günlük tavan, bugünkü harcamayı platformun kendi kredi defterinden okur; açık teklifler ve yeni başlamış işler de 10 dk boyunca sayılır. Böylece eşzamanlı iki çağrı tavanın altından birlikte geçemez.

4. Platform başlatma isteğine net yanıt vermezse istek tekrar gönderilmez (çift ücret riski); sunucu işi iş listesinde arar.

5. Claude Code ayrıca her araç çağrısında izin sorar.

Ayarlar

Ortam değişkenleri ya da EVREN_ENV_FILE'ın gösterdiği dosya (varsayılan: çalışma klasöründeki .env). Süreç ortamındaki değer dosyadakini ezer.

Güvenlik ve gizlilik

• Anahtar yalnız HTTPS ile API alan adına gider; başka alan adındaki indirme bağlantılarına gitmez. Her çıktıda ve hata mesajında maskelenir.

• İstekler dakikada 20 ile ve patlama yumuşatmayla sınırlanır; platformun hız sınırı zorlanmaz (şartlar sınırı atlatmayı yasaklıyor).

• Eğitim günlüğü ve indirilen modeller senin makinende kalır.

• Açık bildirmek için SECURITY.md.

Bilerek olmayanlar

Silme, herkese açık yapma, etiketleme, kullanım şartlarını onaylama, anahtar yönetimi. Bunlar panelde kullanıcının elinde kalır.

Geliştirme

CONTRIBUTING.md. Tasarım: docs/tasarim.md, platformda ölçülen davranış: docs/canli-dogrulama.md.

Lisans

MIT