Langfuse MCP Sunucusu Entegrasyonu

“Langfuse” MCP Sunucusu ne işe yarar?

Langfuse MCP Sunucusu, Langfuse Prompt Yönetimi için tasarlanmış bir Model Context Protocol (MCP) sunucusudur. AI asistanları ve geliştiricilerin Langfuse’da saklanan prompt’lara standart MCP arayüzüyle erişip, yönetmesini sağlar. AI istemcilerini MCP aracılığıyla harici prompt depolarına bağlayarak, prompt’ların alınmasını, listelenmesini ve derlenmesini kolaylaştırır; bu da büyük dil modeli (LLM) geliştirme iş akışını iyileştirir. Langfuse MCP Sunucusu; prompt keşfi, erişimi ve derlemesini destekler, dinamik prompt seçimi ve değişken yerleştirme gibi görevleri mümkün kılar. Bu entegrasyon, prompt yönetimini basitleştirir ve LLM’lerle prompt veritabanları arasındaki etkileşimi standartlaştırır; özellikle takım veya platformlar arasında tutarlı prompt kullanımı ve paylaşımının gerektiği ortamlarda faydalıdır.

Prompt Listesi

• prompts/list: Langfuse deposundaki tüm mevcut prompt’ları listeler. İsteğe bağlı imleç tabanlı (cursor-based) sayfalama desteği vardır ve prompt adları ile gerekli argümanları sağlar. Tüm argümanlar isteğe bağlı varsayılır.
• prompts/get: Belirli bir prompt’u adıyla getirir ve verilen değişkenlerle derler. Hem metin hem sohbet prompt’larını destekler, bunları MCP prompt nesnelerine dönüştürür.

Kaynak Listesi

• Langfuse Prompts Kaynağı: AI istemcilerinin keşfetmesi ve alması için Langfuse’da production etiketiyle işaretlenmiş tüm prompt’ları açar.
• Prompt Argümanları Kaynağı: Prompt değişkenleri hakkında bilgi döndürür (tümü isteğe bağlıdır; Langfuse spesifikasyonu nedeniyle ayrıntılı açıklama yoktur).
• Sayfalı Prompt Kaynağı: Büyük depolarda verimli erişim için prompt’ların sayfalı listelenmesini destekler.

Araç Listesi

• get-prompts: Mevcut prompt’ları ve argümanlarını listeler. Sayfalama için isteğe bağlı cursor parametresi desteklenir, prompt adları ve argümanları listesini döndürür.
• get-prompt: Belirli bir prompt’u getirir ve derler. Bir name parametresi gereklidir ve isteğe bağlı olarak prompt’u doldurmak için bir JSON değişken nesnesi alır.

Bu MCP Sunucusunun Kullanım Senaryoları

• Merkezi Prompt Yönetimi: Tüm prompt’ları Langfuse’da yöneterek, MCP üzerinden çeşitli AI istemcilerine açıp takım genelinde prompt paylaşımını ve güncellemelerini kolaylaştırın.
• Standartlaştırılmış Prompt Erişimi: MCP ile doğrulanmış, üretime hazır prompt’ları ihtiyaç duyulduğunda çekerek LLM iş akışlarında tutarlı prompt kullanımını sağlayın.
• Dinamik Prompt Derleme: LLM veya AI agent’larının çalışma zamanı değişkenleriyle prompt derlemesine olanak tanıyarak esnek ve dinamik etkileşimler sağlayın.
• Uygulamalarda Prompt Keşfi: Geliştirici araçlarında veya AI asistanlarında mevcut prompt’ları ve parametrelerini listeleyerek prompt seçimi arayüzlerini güçlendirin.
• LLMOps İş Akışlarıyla Entegrasyon: Daha iyi prompt yönetişimi ve denetimi için Langfuse prompt depolarını MCP protokolüyle LLMOps platformlarına ve agent framework’lerine bağlayın.

Kurulum Nasıl Yapılır?

Windsurf

Depoda Windsurf için özel bir talimat bulunamadı.

Claude

1. Node.js ve npm’in kurulu olduğundan emin olun.
2. Sunucuyu şu şekilde derleyin:

   npm install
   npm run build
   

3. MCP sunucusunu eklemek için claude_desktop_config.json dosyanızı düzenleyin:

   {
     "mcpServers": {
       "langfuse": {
         "command": "node",
         "args": ["<absolute-path>/build/index.js"],
         "env": {
           "LANGFUSE_PUBLIC_KEY": "public-key'iniz",
           "LANGFUSE_SECRET_KEY": "secret-key'iniz",
           "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
         }
       }
     }
   }
   

4. Çevre değişkenlerini gerçek Langfuse API anahtarlarınızla değiştirin.
5. Yapılandırmayı kaydedin ve Claude Desktop’u yeniden başlatın.
6. Claude Desktop MCP arayüzünde sunucunun kullanılabilir olduğunu doğrulayın.

Cursor

1. Node.js ve npm’in kurulu olduğundan emin olun.
2. Sunucuyu derleyin:

   npm install
   npm run build
   

3. Cursor’da yeni bir MCP sunucusu ekleyin:
   • Ad: Langfuse Prompts
   • Tür: command
   • Komut:

     LANGFUSE_PUBLIC_KEY="public-key'iniz" LANGFUSE_SECRET_KEY="secret-key'iniz" LANGFUSE_BASEURL="https://cloud.langfuse.com" node absolute-path/build/index.js
     

4. Çevre değişkenlerini gerçek Langfuse API anahtarlarınızla değiştirin.
5. Kaydedin ve sunucu bağlantısını doğrulayın.

Cline

Depoda Cline için özel bir talimat bulunamadı.

API Anahtarlarının Güvenliği

API anahtarlarınızı çevre değişkenleri ile güvenceye almanız önerilir. MCP sunucu yapılandırması için örnek bir JSON:

{
  "mcpServers": {
    "langfuse": {
      "command": "node",
      "args": ["<absolute-path>/build/index.js"],
      "env": {
        "LANGFUSE_PUBLIC_KEY": "public-key'iniz",
        "LANGFUSE_SECRET_KEY": "secret-key'iniz",
        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
      }
    }
  }
}

Değerleri gerçek API kimlik bilgilerinizle değiştirin.

Bu MCP’yi Akışlarda Kullanma

FlowHunt’ta MCP kullanımı

FlowHunt iş akışınıza MCP sunucuları entegre etmek için akışınıza MCP bileşenini ekleyin ve AI agent’ınıza bağlayın:

MCP bileşenine tıklayarak yapılandırma panelini açın. Sistem MCP yapılandırma bölümünde, MCP sunucu detaylarınızı şu JSON formatında girin:

{
  "langfuse": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Yapılandırdıktan sonra, AI agent artık bu MCP’nin tüm işlev ve yeteneklerine erişim sağlayabilir. "langfuse" ifadesini kendi MCP sunucu adınızla ve URL’yi kendi MCP sunucu adresinizle değiştirmeyi unutmayın.

Genel Bakış

Mevcut bölüm ve özelliklere göre, Langfuse MCP Sunucusu iyi belgelenmiştir ve özellikle prompt yönetimi için en kritik MCP kabiliyetlerinin çoğunu kapsar. Açık örnekleme veya kök desteğinin olmaması, genişletilebilirliği biraz azaltır. Genel olarak, odaklandığı alan için güçlü bir implementasyondur.

MCP Puanı