Langfuse プロンプト管理 MCP サーバー

Langfuseプロンプト管理用のモデルコンテキストプロトコル（MCP）サーバー。このサーバーを使用すると、モデルコンテキストプロトコルを介してLangfuseプロンプトにアクセスし、管理できます。

デモ

Claude Desktop での Langfuse Prompts MCP の簡単なデモ (音声による説明はミュート解除してください):

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

Related MCP server: Langfuse MCP Server

特徴

MCPプロンプト

このサーバーは、プロンプトの検出と取得のためのMCP プロンプト仕様を実装しています。

• prompts/list : 利用可能なすべてのプロンプトを一覧表示する

  • オプションのカーソルベースのページ区切り

  • プロンプト名とその必須引数を返します。制限：すべての引数はオプションとみなされ、変数にはLangfuseの仕様がないため説明は含まれません。

  • プロンプトが 1 ページ以上ある場合は、ページ区切りの次のカーソルを含めます。

• prompts/get : 特定のプロンプトを取得する

  • Langfuse プロンプト (テキストとチャット) を MCP プロンプト オブジェクトに変換します

  • 提供された変数を使用してプロンプトをコンパイルします

ツール

プロンプト機能をサポートしていない他の MCP クライアントとの互換性を高めるために、サーバーは MCP プロンプトの機能を複製するツールもエクスポートします。

• get-prompts : 利用可能なプロンプトを一覧表示する

  • ページ区切りのオプションのcursorパラメータ

  • プロンプトとその引数のリストを返します

• get-prompt : 特定のプロンプトを取得してコンパイルする

  • 必須のnameパラメータ: 取得するプロンプトの名前

  • オプションのargumentsパラメータ: プロンプト変数を含むJSONオブジェクト

発達

npm install

# build current file
npm run build

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

使用法

ステップ1: 構築

npm install
npm run build

ステップ 2: サーバーを MCP サーバーに追加します。

クロードデスクトップ

claude_desktop_config.jsonを編集して Claude for Desktop を設定します。

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

環境変数を実際のLangfuse APIキーに置き換えてください。これで、Claude Desktopでサーバーが使用できるようになります。

カーソル

カーソルに新しいサーバーを追加します:

• 名前: Langfuse Prompts

• タイプ: command

• 指示：

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

制限事項

MCP サーバーは現在開発中であり、いくつかの制限があります。

• Langfuse のproductionラベルを持つプロンプトのみが返されます

• すべての引数はオプションであると想定されており、変数にはLangfuseの仕様がないため説明は含まれません。

• リスト操作では、引数を抽出するためにバックグラウンドで各プロンプトを個別に取得する必要がありますが、これは機能しますが効率的ではありません。

貢献を歓迎します！ご提案やフィードバックがある場合は、問題または PR (リポジトリ) を開いてください。