langfuse/mcp-reference
Watch
1
0
Fork
You've already forked mcp-reference
 0
mirror of https://github.com/langfuse/mcp-reference.git synced 2026-11-06 12:49:06 +00:00
Code Issues Projects Releases Packages Wiki Activity
Standalone Next.js site for Langfuse MCP servers. The app introspects configured MCP servers at build time, writes static JSON and Markdown artifacts, and renders the same generated snapshot in the browser. https://mcp.reference.langfuse.com
7 commits 3 branches 0 tags 136 KiB
  • TypeScript 99.3%
  • CSS 0.6%
  • JavaScript 0.1%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ben Bachem a3f459e11e
 Add Requires v4 badges (#2)
2026-08-05 16:12:37 +02:00
public/assets delete old images 2026-05-18 11:46:20 +02:00
src Add Requires v4 badges (#2) 2026-08-05 16:12:37 +02:00
tests Add Requires v4 badges (#2) 2026-08-05 16:12:37 +02:00
.gitignore switch to ISR 2026-05-18 11:46:33 +02:00
LICENSE implement initial version 2026-05-18 11:09:01 +02:00
mcp-reference.config.json implement initial version 2026-05-18 11:09:01 +02:00
next-env.d.ts Add Requires v4 badges (#2) 2026-08-05 16:12:37 +02:00
next.config.ts implement initial version 2026-05-18 11:09:01 +02:00
package.json switch to ISR 2026-05-18 11:46:33 +02:00
pnpm-lock.yaml implement initial version 2026-05-18 11:09:01 +02:00
postcss.config.mjs implement initial version 2026-05-18 11:09:01 +02:00
README.md switch to ISR 2026-05-18 11:46:33 +02:00
tsconfig.json implement initial version 2026-05-18 11:09:01 +02:00
vitest.config.ts implement initial version 2026-05-18 11:09:01 +02:00

README.md

Langfuse MCP Servers

Standalone Next.js site for Langfuse MCP servers. The app introspects configured MCP servers from the Next.js server runtime and serves hourly ISR-cached HTML, JSON, and Markdown references.

Local Setup

pnpm install
pnpm dev

The default runtime discovery checks every configured server and fails if any required server cannot be initialized or introspected.

For unauthenticated local work, run the app against only the public Docs MCP server:

MCP_REFERENCE_SERVER_IDS=langfuse-docs pnpm dev

Runtime Credentials

The authenticated Langfuse Cloud MCP server uses project-scoped Basic Auth during server-side discovery:

LANGFUSE_PUBLIC_KEY=pk-lf-your-public-key
LANGFUSE_SECRET_KEY=sk-lf-your-secret-key

The runtime generator constructs Authorization: Basic base64(LANGFUSE_PUBLIC_KEY:LANGFUSE_SECRET_KEY) in memory. Credential values are never written into generated artifacts, snippets, browser code, or logs.

Configuration

mcp-reference.config.json is the source of truth for public MCP servers, authentication requirements, and endpoint variants. The initial catalog includes:

  • langfuse-cloud: authenticated Langfuse Cloud MCP server, introspected from the Cloud EU endpoint and documented with EU, US, Japan, HIPAA, self-hosted, and local variants.
  • langfuse-docs: unauthenticated Langfuse Docs MCP server.

All configured top-level servers are required for the default production runtime.

Generated Output

The public reference endpoints are generated by App Router route handlers and cached with hourly ISR:

  • /: interactive HTML reference by default.
  • /: generated Markdown when the request Accept header prefers Markdown over HTML.
  • /generated/mcp-reference.json: generated machine-readable JSON catalog.
  • /generated/mcp-reference.md: generated Markdown catalog.

Vercel Deployment

Set the Langfuse Cloud credentials in the Vercel project environment, then use the default build command:

pnpm build

The build script runs next build. The deployed Node.js runtime refreshes the generated reference at most once per hour with stale-while-revalidate behavior.

Verification

pnpm test
pnpm typecheck
pnpm build

Runtime checks should confirm the generated JSON and Markdown URLs are served, root-level Markdown content negotiation works, and responses expose ISR cache behavior through x-nextjs-cache in production mode.