Files
umami/packages/mcp/src/http.ts
T

57 lines
1.8 KiB
TypeScript

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' },
);
}