{"_id":"langfuse-observability-mcp-server","_rev":"4-cc7f4ce6f6210004fbda72616fb69458","name":"langfuse-observability-mcp-server","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"langfuse-observability-mcp-server","version":"0.1.0","keywords":["mcp","modelcontextprotocol","langfuse","observability","llm","traces"],"author":{"name":"PulseMCP"},"license":"MIT","_id":"langfuse-observability-mcp-server@0.1.0","maintainers":[{"name":"tadasant","email":"tadas412@gmail.com"}],"homepage":"https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse","bugs":{"url":"https://github.com/pulsemcp/mcp-servers/issues"},"bin":{"langfuse-observability-mcp-server":"build/index.js"},"dist":{"shasum":"9ad9b3df220a8f56d5e13e9d5bdf7611024cda24","tarball":"https://registry.npmjs.org/langfuse-observability-mcp-server/-/langfuse-observability-mcp-server-0.1.0.tgz","fileCount":38,"integrity":"sha512-pg3HtPm0gq8c52/7tR9RA4UbrW5+KbDizq56oR9mcIKI/YlBUiPrI3E5XJH7+QlsIJ++1T9gAKcpiCTOINiOnw==","signatures":[{"sig":"MEYCIQDVjoPgRJe4Chiz34qZfEwXCUlZ62MXKetNZubtvInwEAIhAPvX2MYIKwwezRrlkyWea9UQN9f4iwBHRkzRPj0CLphW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61219},"main":"build/index.js","type":"module","gitHead":"8243d236641cf02b22e3eebb9887def8bccbc699","mcpName":"com.pulsemcp.servers/langfuse","scripts":{"dev":"tsx src/index.ts","lint":"eslint . --ext .ts,.tsx","build":"tsc && npm run build:integration","start":"node build/index.js","format":"prettier --write .","predev":"cd ../shared && npm run build && cd ../local && node setup-dev.js","lint:fix":"eslint . --ext .ts,.tsx --fix","prebuild":"cd ../shared && npm run build && cd ../local && node setup-dev.js","format:check":"prettier --check .","stage-publish":"npm version","prepublishOnly":"node prepare-publish.js && node ../scripts/prepare-npm-readme.js","build:integration":"tsc -p tsconfig.integration.json"},"_npmUser":{"name":"tadasant","email":"tadas412@gmail.com"},"repository":{"url":"git+https://github.com/pulsemcp/mcp-servers.git","type":"git","directory":"experimental/langfuse/local"},"_npmVersion":"11.3.0","description":"Local implementation of Langfuse MCP server","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.19.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.7.3","@types/node":"^22.10.6"},"_npmOperationalInternal":{"tmp":"tmp/langfuse-observability-mcp-server_0.1.0_1770689147643_0.01190267650742971","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"langfuse-observability-mcp-server","version":"0.1.1","keywords":["mcp","modelcontextprotocol","langfuse","observability","llm","traces"],"author":{"name":"PulseMCP"},"license":"MIT","_id":"langfuse-observability-mcp-server@0.1.1","maintainers":[{"name":"tadasant","email":"tadas412@gmail.com"}],"homepage":"https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse","bugs":{"url":"https://github.com/pulsemcp/mcp-servers/issues"},"bin":{"langfuse-observability-mcp-server":"build/index.js"},"dist":{"shasum":"ad83a0ded1991fb225c5a8a99b7b588f57ab4fd2","tarball":"https://registry.npmjs.org/langfuse-observability-mcp-server/-/langfuse-observability-mcp-server-0.1.1.tgz","fileCount":38,"integrity":"sha512-+GL9MKiSNKaeSmKy+9r9krL2fr53Faw4svPci3rYE68baZjc5BXnS+VfW54OyFVFwbBo6/aYD3y50DLPuA+P9Q==","signatures":[{"sig":"MEYCIQCE8EINfqswuBLC9Hr6vpAm1zdZukwHa9GzllR4i2rmMwIhAN8kjgXxxtwRxe4j0U/HmtfKHUOuk277XI9QXh7HCZ14","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61219},"main":"build/index.js","type":"module","gitHead":"4f6525bc4a79f3f22dd12026cbd87db21b8b5683","mcpName":"com.pulsemcp.servers/langfuse","scripts":{"dev":"tsx src/index.ts","lint":"eslint . --ext .ts,.tsx","build":"tsc && npm run build:integration","start":"node build/index.js","format":"prettier --write .","predev":"cd ../shared && npm run build && cd ../local && node setup-dev.js","lint:fix":"eslint . --ext .ts,.tsx --fix","prebuild":"cd ../shared && npm run build && cd ../local && node setup-dev.js","format:check":"prettier --check .","stage-publish":"npm version","prepublishOnly":"node prepare-publish.js && node ../scripts/prepare-npm-readme.js","build:integration":"tsc -p tsconfig.integration.json"},"_npmUser":{"name":"tadasant","email":"tadas412@gmail.com"},"repository":{"url":"git+https://github.com/pulsemcp/mcp-servers.git","type":"git","directory":"experimental/langfuse/local"},"_npmVersion":"11.3.0","description":"Local implementation of Langfuse MCP server","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.19.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.7.3","@types/node":"^22.10.6"},"_npmOperationalInternal":{"tmp":"tmp/langfuse-observability-mcp-server_0.1.1_1775967285188_0.4386799174976834","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"langfuse-observability-mcp-server","version":"0.1.2","keywords":["mcp","modelcontextprotocol","langfuse","observability","llm","traces"],"author":{"name":"PulseMCP"},"license":"MIT","_id":"langfuse-observability-mcp-server@0.1.2","maintainers":[{"name":"tadasant","email":"tadas412@gmail.com"}],"homepage":"https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse","bugs":{"url":"https://github.com/pulsemcp/mcp-servers/issues"},"bin":{"langfuse-observability-mcp-server":"build/index.js"},"dist":{"shasum":"1ed7f525fea6f48f7d104aee444ee8f1fb1d583a","tarball":"https://registry.npmjs.org/langfuse-observability-mcp-server/-/langfuse-observability-mcp-server-0.1.2.tgz","fileCount":38,"integrity":"sha512-a2KT55yicu56eEuME/HSWDvrmr///1rvZGe7pnixwWaYTPje0h13lKW9A80sv6xklJCKqc0T7nNlQ912gVGuyA==","signatures":[{"sig":"MEQCIDblS7I/qiKBcekATk+OqKYxlHeh/4mvED2Gh5j5Cc45AiARvCl7NWO1K/6MUaXgRh+dDnKRUG36vMt9xDYf0+Dx3Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61211},"main":"build/index.js","type":"module","gitHead":"b3fa1030a3fafd7befe891236ecab979678570a1","mcpName":"com.pulsemcp/langfuse","scripts":{"dev":"tsx src/index.ts","lint":"eslint . --ext .ts,.tsx","build":"tsc && npm run build:integration","start":"node build/index.js","format":"prettier --write .","predev":"cd ../shared && npm run build && cd ../local && node setup-dev.js","lint:fix":"eslint . --ext .ts,.tsx --fix","prebuild":"cd ../shared && npm run build && cd ../local && node setup-dev.js","format:check":"prettier --check .","stage-publish":"npm version","prepublishOnly":"node prepare-publish.js && node ../scripts/prepare-npm-readme.js","build:integration":"tsc -p tsconfig.integration.json"},"_npmUser":{"name":"tadasant","email":"tadas412@gmail.com"},"repository":{"url":"git+https://github.com/pulsemcp/mcp-servers.git","type":"git","directory":"experimental/langfuse/local"},"_npmVersion":"11.3.0","description":"Local implementation of Langfuse MCP server","directories":{},"_nodeVersion":"24.2.0","dependencies":{"zod":"^3.24.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.4","typescript":"^5.7.3","@types/node":"^22.10.6"},"_npmOperationalInternal":{"tmp":"tmp/langfuse-observability-mcp-server_0.1.2_1779068694161_0.6820653076212027","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"langfuse-observability-mcp-server","version":"0.1.3","description":"Local implementation of Langfuse MCP server","mcpName":"com.pulsemcp/langfuse","main":"build/index.js","type":"module","bin":{"langfuse-observability-mcp-server":"build/index.js"},"scripts":{"build":"tsc && npm run build:integration","build:integration":"tsc -p tsconfig.integration.json","start":"node build/index.js","dev":"tsx src/index.ts","predev":"cd ../shared && npm run build && cd ../local && node setup-dev.js","prebuild":"cd ../shared && npm run build && cd ../local && node setup-dev.js","prepublishOnly":"node prepare-publish.js && node ../scripts/prepare-npm-readme.js","lint":"eslint . --ext .ts,.tsx","lint:fix":"eslint . --ext .ts,.tsx --fix","format":"prettier --write .","format:check":"prettier --check .","stage-publish":"npm version"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^22.10.6","tsx":"^4.22.4","typescript":"^5.7.3"},"keywords":["mcp","modelcontextprotocol","langfuse","observability","llm","traces"],"author":{"name":"PulseMCP"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/pulsemcp/mcp-servers.git","directory":"experimental/langfuse/local"},"bugs":{"url":"https://github.com/pulsemcp/mcp-servers/issues"},"homepage":"https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse","_id":"langfuse-observability-mcp-server@0.1.3","gitHead":"2933cf865b956a33e6d8201a55a9cb47a66ab260","_nodeVersion":"24.2.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-P7Lwpm8XX/NPLoBa7/2ootc8jDqY8YAfR4Yd9BT0QpFQ17KUGkK7kJSeLIqwE7Zd6/eVIpleBMUbWosRDAf48A==","shasum":"f8774bedbaaac0d0e31975735c7c9a40a3646354","tarball":"https://registry.npmjs.org/langfuse-observability-mcp-server/-/langfuse-observability-mcp-server-0.1.3.tgz","fileCount":38,"unpackedSize":61212,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCXihqLJH539GeqvqCE8X1Ic2nzzhYE/xOcHUZVwAt+DwIgJrQegjSEadHnwt+jG8fy8dy5IMrT2Zc67IkfBQP3MhU="}]},"_npmUser":{"name":"tadasant","email":"tadas412@gmail.com"},"directories":{},"maintainers":[{"name":"tadasant","email":"tadas412@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/langfuse-observability-mcp-server_0.1.3_1781458266992_0.16565115399185504"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-10T02:05:47.446Z","modified":"2026-06-14T17:31:07.551Z","0.1.0":"2026-02-10T02:05:47.787Z","0.1.1":"2026-04-12T04:14:45.310Z","0.1.2":"2026-05-18T01:44:54.305Z","0.1.3":"2026-06-14T17:31:07.136Z"},"bugs":{"url":"https://github.com/pulsemcp/mcp-servers/issues"},"author":{"name":"PulseMCP"},"license":"MIT","homepage":"https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse","keywords":["mcp","modelcontextprotocol","langfuse","observability","llm","traces"],"repository":{"type":"git","url":"git+https://github.com/pulsemcp/mcp-servers.git","directory":"experimental/langfuse/local"},"description":"Local implementation of Langfuse MCP server","maintainers":[{"name":"tadasant","email":"tadas412@gmail.com"}],"readme":"# Langfuse MCP Server\n\n> **Note**: This package is part of the [MCP Servers](https://github.com/pulsemcp/mcp-servers) monorepo. For the latest updates and full source code, visit the [Langfuse MCP Server directory](https://github.com/pulsemcp/mcp-servers/tree/main/experimental/langfuse).\n\n\nMCP server for readonly analysis of [Langfuse](https://langfuse.com) LLM traces and observations. Designed to help agents deeply inspect trace data, debug LLM pipelines, and analyze costs and latency.\n\n## Highlights\n\n- Browse and filter traces by name, user, session, tags, timestamps, and environment\n- Drill into full trace details including all nested observations and scores\n- List and filter observations by type (GENERATION, SPAN, EVENT), model, level, and more\n- Automatic truncation of large payloads (>1000 chars) to /tmp files with grep-friendly references\n- Read-only — no write operations, safe to use without risk of data modification\n\n## Capabilities\n\n### Tools\n\n| Tool               | Description                                                                                    |\n| ------------------ | ---------------------------------------------------------------------------------------------- |\n| `get_traces`       | List traces with filtering and pagination. Returns minimal summary (no I/O fields).            |\n| `get_trace_detail` | Get full trace by ID including observations, scores, input/output, and metadata.               |\n| `get_observations` | List observations with filtering by traceId, type, level, etc. Returns minimal summary.        |\n| `get_observation`  | Get full observation by ID including input, output, model parameters, usage, and cost details. |\n\n### Resources\n\n| Resource            | Description                                     |\n| ------------------- | ----------------------------------------------- |\n| `langfuse://config` | Server configuration and status (for debugging) |\n\n### Large Payload Handling\n\nTrace and observation data often contains very large input/output fields (full prompts, completions, etc.). This server automatically:\n\n1. Truncates any string field longer than 1000 characters\n2. Saves the full content to a `/tmp/langfuse_*.txt` file\n3. Includes the file path in the truncated output\n\nAgents can then use `grep` to search within these files for specific content without loading the entire payload into context.\n\n## Configuration\n\n### Environment Variables\n\n| Variable              | Required | Description                     | Default                      |\n| --------------------- | -------- | ------------------------------- | ---------------------------- |\n| `LANGFUSE_SECRET_KEY` | Yes      | Langfuse secret key (sk-lf-...) | -                            |\n| `LANGFUSE_PUBLIC_KEY` | Yes      | Langfuse public key (pk-lf-...) | -                            |\n| `LANGFUSE_BASE_URL`   | No       | Langfuse API base URL           | `https://cloud.langfuse.com` |\n\n### Claude Desktop Configuration\n\nmacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\nWindows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"langfuse\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"langfuse-observability-mcp-server\"],\n      \"env\": {\n        \"LANGFUSE_SECRET_KEY\": \"sk-lf-your-secret-key\",\n        \"LANGFUSE_PUBLIC_KEY\": \"pk-lf-your-public-key\",\n        \"LANGFUSE_BASE_URL\": \"https://us.cloud.langfuse.com\"\n      }\n    }\n  }\n}\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm run install-all\n\n# Build\nnpm run build\n\n# Development mode\nnpm run dev\n\n# Run functional tests\nnpm test\n\n# Run integration tests\nnpm run test:integration\n\n# Run manual tests (requires .env with real credentials)\nnpm run test:manual\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}