Langfuse MCP Server Langfuse

🚀 言語融合プロンプト管理MCPサーバー

モデルコンテキストプロトコル（Model Context Protocol）サーバー

Langfuse プロンプト管理 用に実装された Model Context Protocol (MCP) サーバーです。このサーバーを使用すると、Model Context Protocol を通じて Langfuse のプロンプトにアクセスし管理することができます。

🎥 デモ

Claude Desktop での Langfuse Prompts MCP のクイックデモ（音声解説付き、ミュートを解除してください）：

動画リンク

✨ 主な機能

MCP プロンプト

このサーバーは、MCP プロンプト仕様 を実装し、プロンプトの発見と検索を行います。

• prompts/list：利用可能なすべてのプロンプトをリスト表示します。

  • オプションのカーソルベースのページングが可能です。
  • プロンプト名とその必要なパラメーターを返します。制限事項：すべてのパラメーターはオプションと仮定され、説明は含まれません。なぜなら、Langfuse では変数に明確な説明がないためです。
  • プロンプトにさらにページがある場合は、次のカーソルを返します。

• prompts/get：特定のプロンプトを取得します。

  • Langfuse のプロンプト（テキストとチャット）を MCP プロンプトオブジェクトに変換します。
  • 提供された変数を使用してプロンプトをコンパイルします。

ツール

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

• get-prompts：利用可能なプロンプトをリスト表示します。

  • ページング用のオプションの cursor パラメーターがあります。
  • プロンプトのリストとそのパラメーターを返します。

• get-prompt：特定のプロンプトを検索しコンパイルします。

  • 必須の name パラメーター：検索するプロンプトの名前です。
  • オプションの arguments パラメーター：プロンプト変数を含む JSON オブジェクトです。

🛠️ 開発

npm install

# 現在のファイルをビルドする
npm run build

# MCP インスペクターでテストする
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 プロンプト
• タイプ：コマンド
• コマンド：

  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 では変数に明確な説明がないためです。
• リスト操作では、パラメーターを抽出するためにバックグラウンドでプロンプトを1つずつ取得する必要があり、これは可能ですが効率が悪いです。

ご貢献を歓迎します！プロジェクトに関する提案やフィードバックがある場合は、リポジトリ の問題またはプルリクエストを通じてお問い合わせください。