Langfuse Prompt Management

Manajemen Prompt Langfuse Server MCP

Model Context Protocol (MCP) Server untuk Manajemen Prompt Langfuse. Server ini memungkinkan Anda mengakses dan mengelola prompt Langfuse melalui Model Context Protocol.

Demo

Demo singkat Prompt Langfuse MCP di Claude Desktop (aktifkan suara untuk penjelasan voice-over):

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

Fitur

Prompt MCP

Server ini mengimplementasikan spesifikasi Prompt MCP untuk penemuan dan pengambilan prompt.

• prompts/list: Menampilkan semua prompt yang tersedia

  • Paginasi berbasis kursor opsional
  • Mengembalikan nama prompt dan argumen yang diperlukan, batasan: semua argumen dianggap opsional dan tidak menyertakan deskripsi karena variabel tidak memiliki spesifikasi di Langfuse
  • Menyertakan kursor berikutnya untuk paginasi jika ada lebih dari 1 halaman prompt

• prompts/get: Mendapatkan prompt tertentu

  • Mengubah prompt Langfuse (teks dan chat) menjadi objek prompt MCP
  • Mengompilasi prompt dengan variabel yang disediakan

Alat

Untuk meningkatkan kompatibilitas dengan klien MCP lain yang tidak mendukung kemampuan prompt, server juga mengekspor alat yang mereplikasi fungsionalitas Prompt MCP.

• get-prompts: Menampilkan prompt yang tersedia

  • Parameter cursor opsional untuk paginasi
  • Mengembalikan daftar prompt beserta argumennya

• get-prompt: Mengambil dan mengompilasi prompt tertentu

  • Parameter name wajib: Nama prompt yang akan diambil
  • Parameter arguments opsional: Objek JSON dengan variabel prompt

Pengembangan

npm install

# build current file
npm run build

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

Penggunaan

Langkah 1: Build

npm install
npm run build

Langkah 2: Tambahkan server ke server MCP Anda:

Claude Desktop

Konfigurasikan Claude untuk Desktop dengan mengedit claude_desktop_config.json

{
  "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"
      }
    }
  }
}

Pastikan untuk mengganti variabel lingkungan dengan kunci API Langfuse Anda yang sebenarnya. Server sekarang akan tersedia untuk digunakan di Claude Desktop.

Cursor

Tambahkan server baru ke Cursor:

• Nama: Langfuse Prompts
• Tipe: command
• Perintah:

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

Batasan

Server MCP ini masih dalam pengembangan dan memiliki beberapa batasan:

• Hanya prompt dengan label production di Langfuse yang dikembalikan
• Semua argumen dianggap opsional dan tidak menyertakan deskripsi karena variabel tidak memiliki spesifikasi di Langfuse
• Operasi daftar memerlukan pengambilan setiap prompt secara individual di latar belakang untuk mengekstrak argumen, ini berfungsi tetapi tidak efisien

Kontribusi sangat diterima! Silakan buka isu atau PR (repo) jika Anda memiliki saran atau masukan.