Chroma MCP Sunucusu Entegrasyonu

“Chroma” MCP Sunucusu ne yapar?

Chroma MCP Sunucusu, Chroma vektör veritabanı aracılığıyla AI asistanlarına güçlü veritabanı yetenekleri kazandıran Model Context Protocol (MCP) uygulamasıdır. Harici veri kaynaklarıyla sorunsuz entegrasyon sağlar; AI modellerinin belge koleksiyonları oluşturmasına, yönetmesine ve sorgulamasına imkan tanır. Tam metin ve semantik arama, metadata filtreleme ve esnek depolama seçenekleri (geçici, kalıcı, HTTP ve bulut) gibi özelliklerle, geliştiricilere LLM’ler için verimli veri erişimi ve yönetim araçları sunarak iş akışlarını güçlendirir. Böylece AI uygulamalarının koleksiyon yönetimi ve belge sorgulama gibi gelişmiş veri işlemlerini yerine getirmesini sağlar; bilgi bulma, bilgi yönetimi ve daha fazlası için geliştirme süreçlerine destek olur.

Komut Listesi

Depoda herhangi bir komut şablonundan bahsedilmemiştir.

Kaynak Listesi

Depoda açıkça belirtilmiş bir kaynak bulunmamaktadır.

Araç Listesi

• chroma_list_collections – Sayfalama desteğiyle tüm koleksiyonları listeler.
• chroma_create_collection – Opsiyonel HNSW yapılandırmasıyla yeni koleksiyon oluşturur.
• chroma_peek_collection – Koleksiyondaki belgelerden bir örneği görüntüler.
• chroma_get_collection_info – Koleksiyon hakkında ayrıntılı bilgi alır.
• chroma_get_collection_count – Koleksiyondaki belge sayısını alır.
• chroma_modify_collection – Koleksiyonun adını veya metasını günceller.
• chroma_delete_collection – Bir koleksiyonu siler.
• chroma_add_documents – Opsiyonel metadata ve özel ID ile belge ekler.
• chroma_query_documents – Gelişmiş filtreleme ile semantik arama yaparak belgeleri sorgular.

Bu MCP Sunucusunun Kullanım Alanları

• Veritabanı Yönetimi
  AI tabanlı uygulamalar için proje ya da uygulama verilerinizi düzenlemek adına kolayca koleksiyon oluşturun, düzenleyin veya silin.
• Semantik ve Tam Metin Arama
  Bağlamsal bilgi bulma gerektiren uygulamalar için gelişmiş belge bulma işlemlerini semantik ve metin tabanlı sorgularla gerçekleştirin.
• Metadata Filtreleme
  Özel iş akışlarını ve veri kategorilendirmesini destekleyecek şekilde, özelleştirilebilir metadata alanlarıyla belgeleri alın ve filtreleyin.
• Belge Alma & Bulma
  Metadata ve ID ile birlikte belgeleri verimli şekilde ekleyin ve çağırın; bilgi tabanı oluşturma ve AI eğitim setleri oluşturmayı kolaylaştırır.
• Koleksiyon Analitiği
  Koleksiyon istatistiklerine ve belge sayılarına erişerek veri depolama ve bulma stratejilerinizi izleyin ve optimize edin.

Kurulum Nasıl Yapılır

Windsurf

1. Node.js ve npm’nin yüklü olduğundan emin olun.
2. Windsurf proje ayarları ya da yapılandırma dizininizi açın.
3. Yapılandırma dosyasını düzenleyerek Chroma MCP Sunucusu’nu ekleyin.
4. mcpServers altında aşağıdaki JSON kodunu ekleyin:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

5. Dosyayı kaydedin ve Windsurf’u yeniden başlatın.
6. MCP sunucu günlüklerini veya panelini kontrol ederek sunucunun çalıştığını doğrulayın.

API Anahtarlarını Güvenli Saklama

Hassas anahtarlar için ortam değişkenleri kullanın:

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Claude

1. Node.js yüklü değilse kurun.
2. Claude yapılandırma dosyasını açın.
3. mcpServers altına şunu ekleyin:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Kaydedin ve Claude’u yeniden başlatın.
5. Başarılı sunucu kaydı için sistem günlüklerini kontrol edin.

API Anahtarlarını Güvenli Saklama

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cursor

1. Ön Koşul: Node.js kurulu olmalı.
2. Cursor’ın ayarlar/yapılandırma dosyasını açın.
3. Chroma MCP Sunucusu yapılandırmasını ekleyin:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Kaydedin ve Cursor’ı yeniden başlatın.
5. Cursor uzantılar panelinden bağlantıyı doğrulayın.

API Anahtarlarını Güvenli Saklama

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cline

1. Node.js’in kurulu olduğundan emin olun.
2. Cline için yapılandırma dosyasına erişin.
3. Chroma MCP Sunucusu’nu ekleyin:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. Değişiklikleri kaydedin ve uygulamayı yeniden başlatın.
5. MCP sunucusunun Cline arayüzünde listelendiğini doğrulayın.

API Anahtarlarını Güvenli Saklama

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Bu MCP’yi Akışlarda Nasıl Kullanırsınız

FlowHunt’ta MCP Kullanımı

MCP sunucularını FlowHunt iş akışınıza entegre etmek için, öncelikle MCP bileşenini akışınıza ekleyin ve AI ajanınza 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ı ile MCP sunucu detaylarınızı ekleyin:

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

Yapılandırmayı tamamladıktan sonra, AI ajanı artık bu MCP’yi tüm fonksiyonlarına erişimi olan bir araç olarak kullanabilir. “chroma-mcp” adını kendi MCP sunucunuzun adıyla, URL’yi ise kendi MCP sunucu URL’niz ile değiştirmeyi unutmayın.

Genel Bakış

Bu MCP sunucusuna 6/10 puan verirdim. Veritabanı araçları ve kurulumu açısından güçlü, ancak komutlar, kaynaklar ve roots ile örnekleme gibi gelişmiş MCP özellikleri için net dökümantasyon eksik.

MCP Puanı