Langfuse

🚀 Shouting MCP Server for Langfuse

A Model Context Protocol (MCP) server implementation for integrating AI assistants with Langfuse workspaces.

🚀 Quick Start

This package provides an MCP server that allows AI assistants to interact with Langfuse workspaces. It enables AI models to query LLM metrics by time range.

✨ Features

• Query LLM metrics by time range.

📦 Installation

# Install from npm
npm install shouting-mcp-langfuse

# Or install globally
npm install -g shouting-mcp-langfuse

You can find the package on npm: shouting-mcp-langfuse

Prerequisites

Before using the server, you need to create a Langfuse project and obtain the project's public and private keys. You can find these keys in the Langfuse control panel.

1. Set up a Langfuse project.
2. Obtain the project's public and private keys.
3. Set environment variables.

Configuration

The server requires the following environment variables:

• LANGFUSE_DOMAIN: Langfuse domain (default: https://api.langfuse.com)
• LANGFUSE_PUBLIC_KEY: Your Langfuse project public key
• LANGFUSE_PRIVATE_KEY: Your Langfuse project private key

💻 Usage Examples

Basic Usage

Run as a CLI tool

# Set environment variables
export LANGFUSE_DOMAIN="https://api.langfuse.com"
export LANGFUSE_PUBLIC_KEY="your-public-key"
export LANGFUSE_PRIVATE_KEY="your-private"

# Run the server
mcp-server-langfuse

Use in code

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { langfuseClient } from "shouting-mcp-langfuse";

// Initialize the server and client
const server = new Server({...});
const langfuseClient = new LangfuseClient(process.env.LANGFUSE_DOMAIN, process.env.LANGFUSE_PUBLIC_KEY, process.env.LANGFUSE_PRIVATE_KEY);

// Register custom handlers
// ...

Advanced Usage

The server provides the following Langfuse integration tools:

• getLLMMetricsByTimeRange: Get LLM metrics by time range.

📄 License

ISC

Author

shouting.hsiao@gmail.com

Repository

https://github.com/z9905080/mcp-langfuse