Skip to content

armgit / umami

Public Imported from GitHub
0

Umami is a privacy-first web and product analytics platform. Traffic, campaigns, behavior, conversions, and revenue in one place. No cookies, no surveillance, self-hosted or in the cloud.

1.8 KB
Raw Blame
import {
  type AuthInfo,
  createMcpHandler,
  type McpHttpHandler,
  type McpRequestContext,
} from '@modelcontextprotocol/server';
import type { UmamiClient } from '@umami/api-client';
import type { McpLogger } from './lib/logger';
import type { AnyToolDefinition } from './lib/tool';
import { createUmamiMcpServer } from './server';

export interface CreateUmamiMcpHttpHandlerOptions {
  /**
   * Builds the API client for one request. Receives the verified `AuthInfo` (bearer token,
   * client ID, scopes) so the token can be propagated to the Umami API unchanged.
   */
  createClient: (authInfo: AuthInfo, ctx: McpRequestContext) => UmamiClient | Promise<UmamiClient>;
  logger?: McpLogger;
  tools?: AnyToolDefinition[];
  onerror?: (error: Error) => void;
}

/**
 * Streamable HTTP handler (web-standard Request/Response) for the 2026-07-28 stateless protocol.
 * The host is responsible for verifying the bearer token and passing `authInfo` to `handler.fetch`.
 */
export function createUmamiMcpHttpHandler(
  options: CreateUmamiMcpHttpHandlerOptions,
): McpHttpHandler {
  return createMcpHandler(
    async ctx => {
      const authInfo = ctx.authInfo;

      if (!authInfo) {
        throw new Error(
          'MCP request is missing authInfo. Verify the bearer token before dispatch.',
        );
      }

      const client = await options.createClient(authInfo, ctx);
      const extra = (authInfo.extra ?? {}) as { userId?: string; requestId?: string };

      return createUmamiMcpServer({
        client,
        logger: options.logger,
        tools: options.tools,
        identity: {
          userId: extra.userId,
          clientId: authInfo.clientId,
          requestId: extra.requestId,
        },
      });
    },
    { onerror: options.onerror, legacy: 'stateless' },
  );
}