Langfuse Prompt Management MCP Server

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

Langfuse プロンプト管理用のModel Context Protocol（MCP）サーバーです。このサーバーを使用すると、Model Context Protocol を通じて Langfuse のプロンプトにアクセスし、管理できます。

デモ

Claude Desktop での Langfuse Prompts MCP の簡単なデモです（音声解説を聞くにはミュートを解除してください）：

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

機能

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

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 でサーバーを使用できるようになります。

Cursor

Cursor に新しいサーバーを追加します：

• 名前：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（リポジトリ）をお寄せください。