Integrácia Langfuse MCP servera

Čo robí “Langfuse” MCP server?

Langfuse MCP Server je server Model Context Protocolu (MCP) navrhnutý pre správu promptov v Langfuse. Umožňuje AI asistentom a vývojárom pristupovať k promptom uloženým v Langfuse a spravovať ich prostredníctvom štandardizovaného MCP rozhrania. Prepájaním AI klientov s externými repozitármi promptov cez MCP tento server zjednodušuje získavanie, výpis a kompiláciu promptov, čím zefektívňuje vývojársky workflow pre veľké jazykové modely (LLM). Langfuse MCP Server podporuje objavovanie, získavanie a kompiláciu promptov, čo umožňuje napríklad dynamický výber promptov a nahrádzanie premenných. Táto integrácia zjednodušuje správu promptov a štandardizuje interakcie medzi LLM a databázami promptov, vďaka čomu je obzvlášť užitočná v prostrediach, kde je potrebné konzistentné používanie a zdieľanie promptov naprieč tímami či platformami.

Zoznam promptov

• prompts/list: Vypíše všetky dostupné prompti v repozitári Langfuse. Podporuje voliteľné stránkovanie na základe kurzora a poskytuje názvy promptov spolu s požadovanými argumentmi. Všetky argumenty sa považujú za voliteľné.
• prompts/get: Získa konkrétny prompt podľa názvu a skompiluje ho s poskytnutými premennými. Podporuje textové aj chat prompti a prevádza ich na MCP prompt objekty.

Zoznam zdrojov

• Langfuse Prompts Resource: Sprístupňuje všetky prompti označené ako production v Langfuse na vyhľadávanie a získavanie AI klientmi.
• Prompt Arguments Resource: Vracia informácie o premenných promptov (všetky sú voliteľné; bez podrobných popisov kvôli obmedzeniam špecifikácie Langfuse).
• Paginated Prompts Resource: Podporuje výpis promptov so stránkovaním pre efektívny prístup vo veľkých repozitároch.

Zoznam nástrojov

• get-prompts: Vypíše dostupné prompti s ich argumentmi. Podporuje voliteľný parameter cursor pre stránkovanie a vracia zoznam názvov promptov a ich argumentov.
• get-prompt: Získa a skompiluje konkrétny prompt. Vyžaduje parameter name a voliteľne prijíma JSON objekt premenných na vyplnenie promptu.

Použitia tohto MCP servera

• Centralizovaná správa promptov: Zjednodušte aktualizácie a zdieľanie promptov naprieč tímami správou všetkých promptov v Langfuse a ich sprístupnením cez MCP rôznym AI klientom.
• Štandardizované získavanie promptov: Zabezpečte konzistentné používanie promptov v LLM workflowoch tým, že MCP slúži na získavanie overených, produkčných promptov na požiadanie.
• Dynamická kompilácia promptov: Umožnite LLM či AI agentom kompilovať prompti s runtime premennými pre flexibilné a dynamické interakcie.
• Objavovanie promptov v aplikáciách: Poháňajte rozhrania na výber promptov vo vývojárskych nástrojoch či AI asistentoch výpisom dostupných promptov a ich parametrov.
• Integrácia s LLMOps workflowmi: Prepájajte repozitáre promptov Langfuse s platformami LLMOps a agentovými frameworkami cez MCP protokol pre lepšiu správu a auditovanie promptov.

Ako to nastaviť

Windsurf

V repozitári neboli nájdené žiadne špecifické inštrukcie pre Windsurf.

Claude

1. Uistite sa, že máte nainštalované Node.js a npm.
2. Server postavíte príkazmi:

   npm install
   npm run build
   

3. Upravte svoj claude_desktop_config.json a pridajte MCP server:

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

4. Environmentálne premenné nahraďte vašimi skutočnými Langfuse API kľúčmi.
5. Uložte konfiguráciu a reštartujte Claude Desktop.
6. Overte dostupnosť servera v rozhraní Claude Desktop MCP.

Cursor

1. Uistite sa, že máte nainštalované Node.js a npm.
2. Postavte server:

   npm install
   npm run build
   

3. V Cursor pridajte nový MCP server:
   • Názov: Langfuse Prompts
   • Typ: command
   • Príkaz:

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

4. Environmentálne premenné nahraďte vašimi skutočnými API kľúčmi.
5. Uložte a overte pripojenie servera.

Cline

V repozitári neboli nájdené špecifické inštrukcie pre Cline.

Zabezpečenie API kľúčov

Odporúča sa zabezpečiť API kľúče prostredníctvom environmentálnych premenných. Príklad JSON úseku pre konfiguráciu MCP servera:

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

Nahraďte hodnoty vašimi skutočnými API údajmi.

Ako tento MCP používať vo flowoch

Použitie MCP vo FlowHunt

Na integráciu MCP serverov do svojho FlowHunt workflowu pridajte do flowu komponent MCP a prepojte ho so svojím AI agentom:

Kliknite na komponent MCP pre otvorenie konfiguračného panela. V sekcii systémovej MCP konfigurácie vložte údaje o vašom MCP serveri v tomto JSON formáte:

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

Po konfigurácii môže AI agent používať tento MCP ako nástroj s prístupom ku všetkým jeho funkciám a možnostiam. Nezabudnite zmeniť "langfuse" na skutočný názov vášho MCP servera a URL na adresu vášho MCP servera.

Prehľad

Podľa dostupných sekcií a funkcií je Langfuse MCP Server dobre zdokumentovaný a pokrýva väčšinu kľúčových MCP schopností, najmä pre správu promptov. Neprítomnosť explicitnej podpory sampling alebo roots mierne znižuje rozšíriteľnosť. Celkovo však ide o silnú implementáciu pre svoju cieľovú oblasť.

MCP skóre