Langfuse Prompt Management

resmi

İşbirlikçi düzenleme, sürümleme, değerlendirme ve prompt yayınlama için açık kaynaklı araç.

Dokümantasyon

Langfuse Prompt Management MCP Sunucusu

Model Context Protocol (MCP) Sunucusu, Langfuse Prompt Management için. Bu sunucu, Model Context Protocol aracılığıyla Langfuse prompt'larınıza erişmenizi ve bunları yönetmenizi sağlar.

Demo

Claude Desktop'ta Langfuse Prompts MCP'nin hızlı demosu (sesli açıklamalar için sesi açın):

https://github.com/user-attachments/assets/61da79af-07c2-4f69-b28c-ca7c6e606405

Özellikler

MCP Prompt

Bu sunucu, prompt keşfi ve alımı için MCP Prompts spesifikasyonunu uygular.

  • prompts/list: Mevcut tüm prompt'ları listele

    • İsteğe bağlı imleç tabanlı sayfalama
    • Prompt adlarını ve gerekli argümanlarını döndürür, kısıtlama: tüm argümanlar isteğe bağlı kabul edilir ve Langfuse'ta değişkenlerin spesifikasyonu olmadığı için açıklamaları içermez
    • Birden fazla prompt sayfası varsa sayfalama için sonraki imleci içerir
  • prompts/get: Belirli bir prompt'u getir

    • Langfuse prompt'larını (metin ve sohbet) MCP prompt nesnelerine dönüştürür
    • Prompt'u sağlanan değişkenlerle derler

Araçlar

Prompt yeteneğini desteklemeyen diğer MCP istemcileriyle uyumluluğu artırmak için sunucu, MCP Prompt'larının işlevselliğini kopyalayan araçları da dışa aktarır.

  • get-prompts: Mevcut prompt'ları listele

    • Sayfalama için isteğe bağlı cursor parametresi
    • Argümanlarıyla birlikte bir prompt listesi döndürür
  • get-prompt: Belirli bir prompt'u al ve derle

    • Gerekli name parametresi: Alınacak prompt'un adı
    • İsteğe bağlı arguments parametresi: Prompt değişkenlerini içeren JSON nesnesi

Geliştirme

npm install

# build current file
npm run build

# test in mcp inspector
npx @modelcontextprotocol/inspector node ./build/index.js

Kullanım

Adım 1: Derleme

npm install
npm run build

Adım 2: Sunucuyu MCP sunucularınıza ekleyin:

Claude Desktop

claude_desktop_config.json dosyasını düzenleyerek Claude for Desktop'ı yapılandırın

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

Ortam değişkenlerini gerçek Langfuse API anahtarlarınızla değiştirdiğinizden emin olun. Sunucu artık Claude Desktop'ta kullanıma hazır olacaktır.

Cursor

Cursor'a yeni sunucu ekleyin:

  • Ad: Langfuse Prompts
  • Tür: command
  • Komut:
    LANGFUSE_PUBLIC_KEY="your-public-key" LANGFUSE_SECRET_KEY="your-secret-key" LANGFUSE_BASEURL="https://cloud.langfuse.com" node absolute-path/build/index.js
    

Kısıtlamalar

MCP Sunucusu geliştirme aşamasındadır ve bazı kısıtlamaları vardır:

  • Yalnızca Langfuse'ta production etiketine sahip prompt'lar döndürülür
  • Tüm argümanlar isteğe bağlı kabul edilir ve Langfuse'ta değişkenlerin spesifikasyonu olmadığı için açıklamaları içermez
  • Listeleme işlemleri, argümanları çıkarmak için arka planda her bir prompt'u ayrı ayrı getirmeyi gerektirir, bu çalışır ancak verimli değildir

Katkılar memnuniyetle karşılanır! Herhangi bir öneriniz veya geri bildiriminiz varsa lütfen bir konu (issue) veya PR açın (repo).