57 lines
1.8 KiB
TypeScript
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' },
|
|
);
|
|
}
|