qyl-mcp-server 0.1.0

package/dist/mcp-errors.d.ts

@@ -0,0 +1,5 @@
+import { ErrorCode, type JSONRPCErrorResponse, type RequestId } from "@modelcontextprotocol/sdk/types.js";
+/** Build a protocol error through the MCP SDK's normative runtime schema. */
+export declare function mcpErrorResponse(code: ErrorCode, message: string, id?: RequestId): JSONRPCErrorResponse;
+/** Preserve an ID only when the request itself is a valid SDK-owned envelope. */
+export declare function mcpRequestId(value: unknown): RequestId | undefined;

package/dist/mcp-errors.js

@@ -0,0 +1,15 @@
+import { JSONRPCErrorResponseSchema, JSONRPCRequestSchema, JSONRPC_VERSION, } from "@modelcontextprotocol/sdk/types.js";
+/** Build a protocol error through the MCP SDK's normative runtime schema. */
+export function mcpErrorResponse(code, message, id) {
+    return JSONRPCErrorResponseSchema.parse({
+        jsonrpc: JSONRPC_VERSION,
+        error: { code, message },
+        ...(id === undefined ? {} : { id }),
+    });
+}
+/** Preserve an ID only when the request itself is a valid SDK-owned envelope. */
+export function mcpRequestId(value) {
+    const parsed = JSONRPCRequestSchema.safeParse(value);
+    return parsed.success ? parsed.data.id : undefined;
+}
+//# sourceMappingURL=mcp-errors.js.map

package/dist/mcp-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-errors.js","sourceRoot":"","sources":["../src/mcp-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,GAGhB,MAAM,oCAAoC,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,IAAe,EACf,OAAe,EACf,EAAc;IAEd,OAAO,0BAA0B,CAAC,KAAK,CAAC;QACtC,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;KACpC,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC"}

package/dist/mcp-semconv.d.ts

@@ -0,0 +1,68 @@
+import { SpanKind, type Attributes } from "@opentelemetry/api";
+import { SecretRedactor } from "./secret-redactor.js";
+export declare const MCP_WELL_KNOWN_METHODS: readonly ["initialize", "notifications/initialized", "ping", "notifications/cancelled", "notifications/progress", "resources/list", "resources/templates/list", "resources/read", "resources/subscribe", "resources/unsubscribe", "notifications/resources/list_changed", "notifications/resources/updated", "prompts/list", "prompts/get", "notifications/prompts/list_changed", "tools/list", "tools/call", "notifications/tools/list_changed", "roots/list", "notifications/roots/list_changed", "logging/setLevel", "notifications/message", "sampling/createMessage", "completion/complete", "elicitation/create"];
+export type McpTelemetryRole = "client" | "server";
+export type McpTelemetryTransport = "stdio" | "http" | "streamable_http" | "streamable-http" | "sse" | "inproc" | "builtin";
+/** Propagation-only MCP metadata. Values are never emitted as attributes. */
+export type McpPropagationCarrier = Readonly<Record<string, string>>;
+interface McpNetworkInput {
+    role: McpTelemetryRole;
+    transport: McpTelemetryTransport;
+    networkProtocolName?: string;
+    networkProtocolVersion?: string;
+    /** Remote server for client signals; remote client for server spans. */
+    peerAddress?: string;
+    peerPort?: number;
+}
+interface McpProtocolInput extends McpNetworkInput {
+    protocolVersion?: string;
+    jsonRpcProtocolVersion?: string;
+    errorType?: string;
+    rpcResponseStatusCode?: string;
+}
+export interface McpOperationInput extends McpProtocolInput {
+    method: string;
+    toolName?: string;
+    promptName?: string;
+    resourceUri?: string;
+    /** `mcp.resource.uri` is opt-in on operation metrics. */
+    recordResourceUriOnMetric?: boolean;
+    mcpSessionId?: string;
+    jsonRpcRequestId?: string | number;
+    serverId?: string;
+    executionId?: string;
+    evaluationRunId?: string;
+    testCaseId?: string;
+    startTimeMs: number;
+    endTimeMs: number;
+    /** Remote propagation extracted from MCP params._meta; never emitted as attributes. */
+    remotePropagation?: McpPropagationCarrier;
+}
+export interface McpSessionInput extends McpProtocolInput {
+    startTimeMs: number;
+    endTimeMs: number;
+}
+export interface McpSpanDescriptor {
+    name: string;
+    kind: SpanKind.CLIENT | SpanKind.SERVER;
+    attributes: Attributes;
+}
+export interface McpMetricDescriptor {
+    name: string;
+    unit: "s";
+    value: number;
+    attributes: Attributes;
+}
+export declare const WorkbenchTelemetryAttributes: {
+    readonly executionId: "qyl.mcp.execution.id";
+    readonly evaluationRunId: "qyl.mcp.evaluation_run.id";
+    readonly testCaseId: "qyl.mcp.test_case.id";
+    readonly serverId: "qyl.mcp.server.id";
+};
+/** Build only attributes defined for the pinned `mcp.client`/`mcp.server` span. */
+export declare function describeMcpOperationSpan(input: McpOperationInput, redactor?: SecretRedactor): McpSpanDescriptor;
+/** Build only attributes defined for the pinned operation-duration histogram. */
+export declare function describeMcpOperationMetric(input: McpOperationInput, redactor?: SecretRedactor): McpMetricDescriptor;
+/** Build only attributes defined for the pinned session-duration histogram. */
+export declare function describeMcpSessionMetric(input: McpSessionInput, redactor?: SecretRedactor): McpMetricDescriptor;
+export {};

package/dist/mcp-semconv.js

@@ -0,0 +1,208 @@
+import { SpanKind } from "@opentelemetry/api";
+import { ATTR_CLIENT_ADDRESS, ATTR_CLIENT_PORT, ATTR_ERROR_TYPE, ATTR_NETWORK_PROTOCOL_NAME, ATTR_NETWORK_PROTOCOL_VERSION, ATTR_NETWORK_TRANSPORT, ATTR_SERVER_ADDRESS, ATTR_SERVER_PORT, NETWORK_TRANSPORT_VALUE_PIPE, NETWORK_TRANSPORT_VALUE_TCP, } from "@opentelemetry/semantic-conventions";
+import { ATTR_GEN_AI_OPERATION_NAME, ATTR_GEN_AI_PROMPT_NAME, ATTR_GEN_AI_TOOL_NAME, ATTR_JSONRPC_PROTOCOL_VERSION, ATTR_JSONRPC_REQUEST_ID, ATTR_MCP_METHOD_NAME, ATTR_MCP_PROTOCOL_VERSION, ATTR_MCP_RESOURCE_URI, ATTR_MCP_SESSION_ID, ATTR_RPC_RESPONSE_STATUS_CODE, GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL, METRIC_MCP_CLIENT_OPERATION_DURATION, METRIC_MCP_CLIENT_SESSION_DURATION, METRIC_MCP_SERVER_OPERATION_DURATION, METRIC_MCP_SERVER_SESSION_DURATION, } from "@opentelemetry/semantic-conventions/incubating";
+import { SecretRedactor } from "./secret-redactor.js";
+const ATTRIBUTE_VALUE_LIMIT = 2_000;
+const JSONRPC_DEFAULT_VERSION = "2.0";
+export const MCP_WELL_KNOWN_METHODS = [
+    "initialize",
+    "notifications/initialized",
+    "ping",
+    "notifications/cancelled",
+    "notifications/progress",
+    "resources/list",
+    "resources/templates/list",
+    "resources/read",
+    "resources/subscribe",
+    "resources/unsubscribe",
+    "notifications/resources/list_changed",
+    "notifications/resources/updated",
+    "prompts/list",
+    "prompts/get",
+    "notifications/prompts/list_changed",
+    "tools/list",
+    "tools/call",
+    "notifications/tools/list_changed",
+    "roots/list",
+    "notifications/roots/list_changed",
+    "logging/setLevel",
+    "notifications/message",
+    "sampling/createMessage",
+    "completion/complete",
+    "elicitation/create",
+];
+export const WorkbenchTelemetryAttributes = {
+    executionId: "qyl.mcp.execution.id",
+    evaluationRunId: "qyl.mcp.evaluation_run.id",
+    testCaseId: "qyl.mcp.test_case.id",
+    serverId: "qyl.mcp.server.id",
+};
+/** Build only attributes defined for the pinned `mcp.client`/`mcp.server` span. */
+export function describeMcpOperationSpan(input, redactor = new SecretRedactor()) {
+    validateTiming(input.startTimeMs, input.endTimeMs);
+    const safe = safeText(redactor);
+    const method = requireText(input.method, "method", safe);
+    const attributes = { [ATTR_MCP_METHOD_NAME]: method };
+    addOperationCommon(attributes, input, safe, true);
+    if (input.mcpSessionId)
+        attributes[ATTR_MCP_SESSION_ID] = safe(input.mcpSessionId);
+    if (input.jsonRpcRequestId !== undefined) {
+        attributes[ATTR_JSONRPC_REQUEST_ID] = safe(String(input.jsonRpcRequestId));
+    }
+    if (input.resourceUri && resourceMethodHasUri(input.method)) {
+        attributes[ATTR_MCP_RESOURCE_URI] = bounded(redactor.redactUri(input.resourceUri));
+    }
+    addPeerAttributes(attributes, input, safe, true);
+    addWorkbenchSpanAttributes(attributes, input, safe);
+    const target = input.method === "tools/call"
+        ? input.toolName
+        : input.method === "prompts/get" ? input.promptName : undefined;
+    return {
+        name: target ? `${method} ${safe(target)}` : method,
+        kind: input.role === "client" ? SpanKind.CLIENT : SpanKind.SERVER,
+        attributes,
+    };
+}
+/** Build only attributes defined for the pinned operation-duration histogram. */
+export function describeMcpOperationMetric(input, redactor = new SecretRedactor()) {
+    validateTiming(input.startTimeMs, input.endTimeMs);
+    const safe = safeText(redactor);
+    const attributes = {
+        [ATTR_MCP_METHOD_NAME]: requireText(input.method, "method", safe),
+    };
+    addOperationCommon(attributes, input, safe, false);
+    if (input.recordResourceUriOnMetric && input.resourceUri && resourceMethodHasUri(input.method)) {
+        attributes[ATTR_MCP_RESOURCE_URI] = bounded(redactor.redactUri(input.resourceUri));
+    }
+    addPeerAttributes(attributes, input, safe, false);
+    return {
+        name: input.role === "client"
+            ? METRIC_MCP_CLIENT_OPERATION_DURATION
+            : METRIC_MCP_SERVER_OPERATION_DURATION,
+        unit: "s",
+        value: durationSeconds(input.startTimeMs, input.endTimeMs),
+        attributes,
+    };
+}
+/** Build only attributes defined for the pinned session-duration histogram. */
+export function describeMcpSessionMetric(input, redactor = new SecretRedactor()) {
+    validateTiming(input.startTimeMs, input.endTimeMs);
+    const safe = safeText(redactor);
+    const attributes = {};
+    // rpc.response.status_code is defined for MCP operations, not sessions.
+    addProtocolAndNetwork(attributes, input, safe, false);
+    addPeerAttributes(attributes, input, safe, false);
+    return {
+        name: input.role === "client"
+            ? METRIC_MCP_CLIENT_SESSION_DURATION
+            : METRIC_MCP_SERVER_SESSION_DURATION,
+        unit: "s",
+        value: durationSeconds(input.startTimeMs, input.endTimeMs),
+        attributes,
+    };
+}
+function addOperationCommon(attributes, input, safe, span) {
+    addProtocolAndNetwork(attributes, input, safe);
+    if (input.method === "tools/call") {
+        attributes[ATTR_GEN_AI_OPERATION_NAME] = GEN_AI_OPERATION_NAME_VALUE_EXECUTE_TOOL;
+    }
+    if (input.method === "tools/call" && input.toolName) {
+        attributes[ATTR_GEN_AI_TOOL_NAME] = safe(input.toolName);
+    }
+    if (input.method === "prompts/get" && input.promptName) {
+        attributes[ATTR_GEN_AI_PROMPT_NAME] = safe(input.promptName);
+    }
+    // Arguments/results/prompt variables are deliberately not captured: those
+    // registry attributes are opt-in and may contain credentials or user data.
+    if (!span)
+        return;
+}
+function addProtocolAndNetwork(attributes, input, safe, includeRpcResponseStatusCode = true) {
+    if (input.errorType)
+        attributes[ATTR_ERROR_TYPE] = safe(input.errorType);
+    if (input.protocolVersion)
+        attributes[ATTR_MCP_PROTOCOL_VERSION] = safe(input.protocolVersion);
+    if (input.jsonRpcProtocolVersion && input.jsonRpcProtocolVersion !== JSONRPC_DEFAULT_VERSION) {
+        attributes[ATTR_JSONRPC_PROTOCOL_VERSION] = safe(input.jsonRpcProtocolVersion);
+    }
+    if (includeRpcResponseStatusCode && input.rpcResponseStatusCode) {
+        attributes[ATTR_RPC_RESPONSE_STATUS_CODE] = safe(input.rpcResponseStatusCode);
+    }
+    const transport = networkTransport(input.transport);
+    if (transport)
+        attributes[ATTR_NETWORK_TRANSPORT] = transport;
+    const protocolName = input.networkProtocolName ?? inferredNetworkProtocol(input.transport);
+    if (protocolName)
+        attributes[ATTR_NETWORK_PROTOCOL_NAME] = safe(protocolName);
+    if (input.networkProtocolVersion) {
+        attributes[ATTR_NETWORK_PROTOCOL_VERSION] = safe(input.networkProtocolVersion);
+    }
+}
+function addPeerAttributes(attributes, input, safe, span) {
+    if (input.role === "client") {
+        if (input.peerAddress)
+            attributes[ATTR_SERVER_ADDRESS] = safe(input.peerAddress);
+        if (input.peerAddress && input.peerPort !== undefined)
+            attributes[ATTR_SERVER_PORT] = input.peerPort;
+        return;
+    }
+    // Server metrics do not define client.address/client.port; server spans do.
+    if (span && input.peerAddress)
+        attributes[ATTR_CLIENT_ADDRESS] = safe(input.peerAddress);
+    if (span && input.peerAddress && input.peerPort !== undefined)
+        attributes[ATTR_CLIENT_PORT] = input.peerPort;
+}
+function addWorkbenchSpanAttributes(attributes, input, safe) {
+    if (input.serverId)
+        attributes[WorkbenchTelemetryAttributes.serverId] = safe(input.serverId);
+    if (input.executionId)
+        attributes[WorkbenchTelemetryAttributes.executionId] = safe(input.executionId);
+    if (input.evaluationRunId) {
+        attributes[WorkbenchTelemetryAttributes.evaluationRunId] = safe(input.evaluationRunId);
+    }
+    if (input.testCaseId)
+        attributes[WorkbenchTelemetryAttributes.testCaseId] = safe(input.testCaseId);
+}
+function resourceMethodHasUri(method) {
+    return method === "resources/read"
+        || method === "resources/subscribe"
+        || method === "resources/unsubscribe"
+        || method === "notifications/resources/updated";
+}
+function networkTransport(transport) {
+    if (transport === "stdio")
+        return NETWORK_TRANSPORT_VALUE_PIPE;
+    if (transport === "http" || transport === "streamable_http"
+        || transport === "streamable-http" || transport === "sse") {
+        return NETWORK_TRANSPORT_VALUE_TCP;
+    }
+    return undefined;
+}
+function inferredNetworkProtocol(transport) {
+    return transport === "http" || transport === "streamable_http"
+        || transport === "streamable-http" || transport === "sse"
+        ? "http"
+        : undefined;
+}
+function safeText(redactor) {
+    return (value) => bounded(redactor.redactText(value));
+}
+function requireText(value, name, safe) {
+    if (value.trim().length === 0)
+        throw new Error(`${name} must not be empty.`);
+    return safe(value);
+}
+function bounded(value) {
+    return value.length <= ATTRIBUTE_VALUE_LIMIT
+        ? value
+        : `${value.slice(0, ATTRIBUTE_VALUE_LIMIT - 1)}…`;
+}
+function validateTiming(startTimeMs, endTimeMs) {
+    if (!Number.isFinite(startTimeMs) || !Number.isFinite(endTimeMs) || endTimeMs < startTimeMs) {
+        throw new Error("MCP telemetry timestamps must be finite and ordered.");
+    }
+}
+function durationSeconds(startTimeMs, endTimeMs) {
+    return (endTimeMs - startTimeMs) / 1_000;
+}
+//# sourceMappingURL=mcp-semconv.js.map

package/dist/mcp-semconv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-semconv.js","sourceRoot":"","sources":["../src/mcp-semconv.ts"],"names":[],"mappings":"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"}

package/dist/native-execution.d.ts

@@ -0,0 +1,132 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { type CallToolRequest, type CallToolResult, type ServerNotification, type ServerRequest } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import type { McpTelemetryTransport } from "./mcp-semconv.js";
+import { SecretRedactor } from "./secret-redactor.js";
+import { McpTelemetry } from "./telemetry.js";
+declare const NativeExecutionRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    serverId: z.ZodLiteral<"qyl.mcp/native">;
+    status: z.ZodEnum<{
+        failed: "failed";
+        running: "running";
+        succeeded: "succeeded";
+    }>;
+    createdAt: z.ZodString;
+    startedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    attemptCount: z.ZodLiteral<1>;
+    request: z.ZodObject<{
+        requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        toolName: z.ZodString;
+        arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        transport: z.ZodEnum<{
+            builtin: "builtin";
+            http: "http";
+            inproc: "inproc";
+            sse: "sse";
+            stdio: "stdio";
+            "streamable-http": "streamable-http";
+            streamable_http: "streamable_http";
+        }>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    tokenUsage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        estimated: z.ZodBoolean;
+    }, z.core.$strict>>;
+    cost: z.ZodOptional<z.ZodObject<{
+        amountUsd: z.ZodNumber;
+        estimated: z.ZodBoolean;
+        source: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    protocolEvents: z.ZodArray<z.ZodObject<{
+        sequence: z.ZodNumber;
+        timestamp: z.ZodString;
+        direction: z.ZodEnum<{
+            inbound: "inbound";
+            outbound: "outbound";
+        }>;
+        messageKind: z.ZodEnum<{
+            error: "error";
+            request: "request";
+            result: "result";
+        }>;
+        jsonrpc: z.ZodLiteral<"2.0">;
+        requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        method: z.ZodLiteral<"tools/call">;
+        payload: z.ZodUnknown;
+    }, z.core.$strict>>;
+    telemetryCorrelation: z.ZodObject<{
+        executionId: z.ZodString;
+        traceIds: z.ZodArray<z.ZodString>;
+        spanIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type NativeExecutionRecord = z.infer<typeof NativeExecutionRecordSchema>;
+export interface NativeExecutionRepository {
+    save(record: NativeExecutionRecord): Promise<void>;
+}
+export interface FileNativeExecutionRepositoryOptions {
+    filePath?: string;
+    maxExecutions?: number;
+    now?: () => number;
+    redactor?: SecretRedactor;
+    environment?: Readonly<Record<string, string | undefined>>;
+}
+/** Durable, redacted native-server evidence kept separately from workbench state. */
+export declare class FileNativeExecutionRepository implements NativeExecutionRepository {
+    private readonly store;
+    private readonly maxExecutions;
+    private readonly now;
+    private initialization;
+    constructor(options?: FileNativeExecutionRepositoryOptions);
+    save(record: NativeExecutionRecord): Promise<void>;
+    list(): Promise<NativeExecutionRecord[]>;
+    private initialize;
+    private initializeCore;
+}
+export interface NativeExecutionTelemetry {
+    startOperation: McpTelemetry["startOperation"];
+    close?(): Promise<void>;
+}
+export interface NativeExecutionRuntimeOptions {
+    telemetry?: NativeExecutionTelemetry;
+    redactor?: SecretRedactor;
+    now?: () => number;
+    id?: () => string;
+}
+export interface NativeToolCallInput {
+    request: CallToolRequest;
+    extra: RequestHandlerExtra<ServerRequest, ServerNotification>;
+    transport: McpTelemetryTransport;
+}
+/** Owns the automatic inbound tools/call lifecycle and evidence transaction. */
+export declare class NativeExecutionRuntime {
+    private readonly repository;
+    private readonly telemetry?;
+    private readonly redactor;
+    private readonly now;
+    private readonly id;
+    constructor(repository: NativeExecutionRepository, options?: NativeExecutionRuntimeOptions);
+    execute(input: NativeToolCallInput, invoke: () => unknown | Promise<unknown>): Promise<CallToolResult>;
+    close(): Promise<void>;
+    get telemetryEnabled(): boolean;
+    private startTelemetry;
+}
+/** Wrap the SDK's single tools/call dispatcher, covering all current and future tools. */
+export declare function installNativeExecutionRecording(server: McpServer, runtime: NativeExecutionRuntime, transport: McpTelemetryTransport): void;
+export declare function hasNativeExecutionTelemetry(server: unknown): boolean;
+export declare function defaultNativeExecutionRuntime(environment?: Readonly<Record<string, string | undefined>>): NativeExecutionRuntime;
+export declare function closeDefaultNativeExecutionRuntime(): Promise<void>;
+export {};