MCP Server Langfuse

🚀 コンテキストモデルプロトコル (MCP) サーバ - Langfuse プロンプト管理

このサーバは、Langfuse プロンプト管理 の Model Context Protocol (MCP) を実装しており、Model Context Protocol を通じて Langfuse プロンプトにアクセスし管理することを可能にします。

✨ 主な機能

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 ファイルを編集します：

{
  "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 での追加

• 名前：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 サーバはまだ開発段階であり、いくつかの制限があります。

• production タグが付いた Langfuse のプロンプトのみが返されます
• すべてのパラメータはオプションと仮定され、説明は含まれません（Langfuse の変数には説明がないため）
• リスト操作では、パラメータを抽出するためにバックグラウンドでプロンプトを1つずつ取得する必要があり、これは可能ですが効率が低いです

ご貢献いただけると幸いです！改善やフィードバックに関するアイデアがあれば、リポジトリ を通じて問題やプルリクエストを送信してください。