Langfuse Prompt Management MCP Server

1# Langfuse Prompt Management MCP Server
2 
3[Model Context Protocol](https://github.com/modelcontextprotocol) (MCP) Server for [Langfuse Prompt Management](https://langfuse.com/docs/prompts/get-started). This server allows you to access and manage your Langfuse prompts through the Model Context Protocol.
4 
5## Demo
6 
7Quick demo of Langfuse Prompts MCP in Claude Desktop (_unmute for voice-over explanations_):
8 
9https://github.com/user-attachments/assets/61da79af-07c2-4f69-b28c-ca7c6e606405
10 
11## Features
12 
13### MCP Prompt
14 
15This server implements the [MCP Prompts specification](https://modelcontextprotocol.io/docs/concepts/prompts) for prompt discovery and retrieval.
16 
17- `prompts/list`: List all available prompts
18 
19  - Optional cursor-based pagination
20  - Returns prompt names and their required arguments, limitation: all arguments are assumed to be optional and do not include descriptions as variables do not have specification in Langfuse
21  - Includes next cursor for pagination if there's more than 1 page of prompts
22 
23- `prompts/get`: Get a specific prompt
24 
25  - Transforms Langfuse prompts (text and chat) into MCP prompt objects
26  - Compiles prompt with provided variables
27 
28### Tools
29 
30To increase compatibility with other MCP clients that do not support the prompt capability, the server also exports tools that replicate the functionality of the MCP Prompts.
31 
32- `get-prompts`: List available prompts
33 
34  - Optional `cursor` parameter for pagination
35  - Returns a list of prompts with their arguments
36 
37- `get-prompt`: Retrieve and compile a specific prompt
38  - Required `name` parameter: Name of the prompt to retrieve
39  - Optional `arguments` parameter: JSON object with prompt variables
40 
41## Development
42 
43```bash
44npm install
45 
46# build current file
47npm run build
48 
49# test in mcp inspector
50npx @modelcontextprotocol/inspector node ./build/index.js
51```
52 
53## Usage
54 
55### Step 1: Build
56 
57```bash
58npm install
59npm run build
60```
61 
62### Step 2: Add the server to your MCP servers:
63 
64#### Claude Desktop
65 
66Configure Claude for Desktop by editing `claude_desktop_config.json`
67 
68```json
69{
70  "mcpServers": {
71    "langfuse": {
72      "command": "node",
73      "args": ["<absolute-path>/build/index.js"],
74      "env": {
75        "LANGFUSE_PUBLIC_KEY": "your-public-key",
76        "LANGFUSE_SECRET_KEY": "your-secret-key",
77        "LANGFUSE_BASEURL": "https://cloud.langfuse.com"
78      }
79    }
80  }
81}
82```
83 
84Make sure to replace the environment variables with your actual Langfuse API keys. The server will now be available to use in Claude Desktop.
85 
86#### Cursor
87 
88Add new server to Cursor:
89 
90- Name: `Langfuse Prompts`
91- Type: `command`
92- Command:
93  ```bash
94  LANGFUSE_PUBLIC_KEY="your-public-key" LANGFUSE_SECRET_KEY="your-secret-key" LANGFUSE_BASEURL="https://cloud.langfuse.com" node absolute-path/build/index.js
95  ```
96 
97## Limitations
98 
99The MCP Server is a work in progress and has some limitations:
100 
101- Only prompts with a `production` label in Langfuse are returned
102- All arguments are assumed to be optional and do not include descriptions as variables do not have specification in Langfuse
103- List operations require fetching each prompt individually in the background to extract the arguments, this works but is not efficient
104 
105Contributions are welcome! Please open an issue or a PR ([repo](https://github.com/langfuse/mcp-server-langfuse)) if you have any suggestions or feedback.
106