@myrialabs/clopen 0.0.4 → 0.0.6

package/backend/lib/mcp/servers/helper.ts

@@ -1,143 +1,143 @@
-/**
- * Helper to define MCP servers with automatic metadata extraction
- *
- * Stores both the Claude SDK server instance AND raw tool definitions
- * so the same source can be used for Claude Code (in-process) and
- * Open Code (stdio subprocess via @modelcontextprotocol/sdk).
- */
-
-import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
-import type { z } from "zod";
-
-/**
- * Infer argument types from Zod schema
- */
-type InferArgs<TSchema extends Record<string, z.ZodType<any>>> = {
-	[K in keyof TSchema]: z.infer<TSchema[K]>;
-};
-
-/**
- * Content types for MCP responses
- */
-type MCPContent =
-	| { type: "text"; text: string }
-	| { type: "image"; data: string; mimeType: string };
-
-/**
- * Tool handler type - infers args type from schema
- */
-type ToolHandler<TSchema extends Record<string, z.ZodType<any>> | undefined> =
-	TSchema extends Record<string, z.ZodType<any>>
-		? (args: InferArgs<TSchema>) => Promise<{ content: Array<MCPContent>; isError?: boolean }>
-		: () => Promise<{ content: Array<MCPContent>; isError?: boolean }>;
-
-/**
- * Raw tool definition — schema, description, and handler.
- * Single source of truth used by:
- * - Claude Code: in-process via createSdkMcpServer
- * - Open Code stdio: schema/description for registration, handler via bridge
- * - MCP bridge: handler for in-process execution
- */
-export interface RawToolDef {
-	description: string;
-	schema: Record<string, z.ZodType<any>>;
-	handler: (args: any) => Promise<{ content: Array<{ type: string; text?: string; data?: string; mimeType?: string }>; isError?: boolean }>;
-}
-
-/**
- * Server instance with metadata
- */
-interface ServerWithMeta<
-	TName extends string,
-	TToolNames extends readonly string[]
-> {
-	server: ReturnType<typeof createSdkMcpServer>;
-	meta: {
-		readonly name: TName;
-		readonly tools: TToolNames;
-		/** Raw tool definitions (schema + description) for reuse by other transports */
-		readonly toolDefs: Record<string, RawToolDef>;
-	};
-}
-
-/**
- * Define an MCP server with automatic metadata extraction and full type inference
- */
-export function defineServer<
-	const TConfig extends {
-		name: string;
-		version: string;
-		tools: Record<string, { description: string; schema?: any; handler: any }>;
-	}
->(
-	config: TConfig & {
-		tools: {
-			[K in keyof TConfig['tools']]: TConfig['tools'][K] extends { schema: infer S extends Record<string, z.ZodType<any>> }
-				? { description: string; schema: S; handler: ToolHandler<S> }
-				: { description: string; handler: ToolHandler<undefined> }
-		}
-	}
-): ServerWithMeta<TConfig['name'], ReadonlyArray<keyof TConfig['tools'] & string>> {
-	// Extract tool names
-	const toolNames = Object.keys(config.tools) as Array<keyof TConfig['tools'] & string>;
-
-	// Build raw tool definitions (engine-agnostic)
-	const toolDefs: Record<string, RawToolDef> = {};
-
-	// Convert tools object to SDK format (array of tools)
-	const sdkTools = toolNames.map((toolName) => {
-		const toolDef = config.tools[toolName] as any;
-		// If schema is not provided, use empty object
-		const schema = toolDef.schema || {};
-
-		// Store raw definition for reuse
-		toolDefs[toolName as string] = {
-			description: toolDef.description,
-			schema,
-			handler: toolDef.handler,
-		};
-
-		return tool(toolName as string, toolDef.description, schema, toolDef.handler);
-	});
-
-	// Create SDK server
-	const server = createSdkMcpServer({
-		name: config.name,
-		version: config.version,
-		tools: sdkTools
-	});
-
-	// Return server with metadata
-	return {
-		server,
-		meta: {
-			name: config.name,
-			tools: toolNames as any,
-			toolDefs,
-		}
-	};
-}
-
-/**
- * Build server registries from array of servers
- */
-export function buildServerRegistries<
-	T extends readonly ServerWithMeta<string, readonly string[]>[]
->(servers: T) {
-	const metadata = {} as any;
-	const registry = {} as any;
-
-	for (const server of servers) {
-		metadata[server.meta.name] = server.meta;
-		registry[server.meta.name] = server.server;
-	}
-
-	return {
-		metadata: metadata as {
-			[K in T[number]['meta']['name']]: Extract<T[number], { meta: { name: K } }>['meta']
-		},
-		registry: registry as {
-			[K in T[number]['meta']['name']]: Extract<T[number], { meta: { name: K } }>['server']
-		}
-	};
-}
+/**
+ * Helper to define MCP servers with automatic metadata extraction
+ *
+ * Stores both the Claude SDK server instance AND raw tool definitions
+ * so the same source can be used for Claude Code (in-process) and
+ * Open Code (stdio subprocess via @modelcontextprotocol/sdk).
+ */
+
+import { createSdkMcpServer, tool } from "@anthropic-ai/claude-agent-sdk";
+import type { z } from "zod";
+
+/**
+ * Infer argument types from Zod schema
+ */
+type InferArgs<TSchema extends Record<string, z.ZodType<any>>> = {
+	[K in keyof TSchema]: z.infer<TSchema[K]>;
+};
+
+/**
+ * Content types for MCP responses
+ */
+type MCPContent =
+	| { type: "text"; text: string }
+	| { type: "image"; data: string; mimeType: string };
+
+/**
+ * Tool handler type - infers args type from schema
+ */
+type ToolHandler<TSchema extends Record<string, z.ZodType<any>> | undefined> =
+	TSchema extends Record<string, z.ZodType<any>>
+		? (args: InferArgs<TSchema>) => Promise<{ content: Array<MCPContent>; isError?: boolean }>
+		: () => Promise<{ content: Array<MCPContent>; isError?: boolean }>;
+
+/**
+ * Raw tool definition — schema, description, and handler.
+ * Single source of truth used by:
+ * - Claude Code: in-process via createSdkMcpServer
+ * - Open Code stdio: schema/description for registration, handler via bridge
+ * - MCP bridge: handler for in-process execution
+ */
+export interface RawToolDef {
+	description: string;
+	schema: Record<string, z.ZodType<any>>;
+	handler: (args: any) => Promise<{ content: Array<{ type: string; text?: string; data?: string; mimeType?: string }>; isError?: boolean }>;
+}
+
+/**
+ * Server instance with metadata
+ */
+interface ServerWithMeta<
+	TName extends string,
+	TToolNames extends readonly string[]
+> {
+	server: ReturnType<typeof createSdkMcpServer>;
+	meta: {
+		readonly name: TName;
+		readonly tools: TToolNames;
+		/** Raw tool definitions (schema + description) for reuse by other transports */
+		readonly toolDefs: Record<string, RawToolDef>;
+	};
+}
+
+/**
+ * Define an MCP server with automatic metadata extraction and full type inference
+ */
+export function defineServer<
+	const TConfig extends {
+		name: string;
+		version: string;
+		tools: Record<string, { description: string; schema?: any; handler: any }>;
+	}
+>(
+	config: TConfig & {
+		tools: {
+			[K in keyof TConfig['tools']]: TConfig['tools'][K] extends { schema: infer S extends Record<string, z.ZodType<any>> }
+				? { description: string; schema: S; handler: ToolHandler<S> }
+				: { description: string; handler: ToolHandler<undefined> }
+		}
+	}
+): ServerWithMeta<TConfig['name'], ReadonlyArray<keyof TConfig['tools'] & string>> {
+	// Extract tool names
+	const toolNames = Object.keys(config.tools) as Array<keyof TConfig['tools'] & string>;
+
+	// Build raw tool definitions (engine-agnostic)
+	const toolDefs: Record<string, RawToolDef> = {};
+
+	// Convert tools object to SDK format (array of tools)
+	const sdkTools = toolNames.map((toolName) => {
+		const toolDef = config.tools[toolName] as any;
+		// If schema is not provided, use empty object
+		const schema = toolDef.schema || {};
+
+		// Store raw definition for reuse
+		toolDefs[toolName as string] = {
+			description: toolDef.description,
+			schema,
+			handler: toolDef.handler,
+		};
+
+		return tool(toolName as string, toolDef.description, schema, toolDef.handler);
+	});
+
+	// Create SDK server
+	const server = createSdkMcpServer({
+		name: config.name,
+		version: config.version,
+		tools: sdkTools
+	});
+
+	// Return server with metadata
+	return {
+		server,
+		meta: {
+			name: config.name,
+			tools: toolNames as any,
+			toolDefs,
+		}
+	};
+}
+
+/**
+ * Build server registries from array of servers
+ */
+export function buildServerRegistries<
+	T extends readonly ServerWithMeta<string, readonly string[]>[]
+>(servers: T) {
+	const metadata = {} as any;
+	const registry = {} as any;
+
+	for (const server of servers) {
+		metadata[server.meta.name] = server.meta;
+		registry[server.meta.name] = server.server;
+	}
+
+	return {
+		metadata: metadata as {
+			[K in T[number]['meta']['name']]: Extract<T[number], { meta: { name: K } }>['meta']
+		},
+		registry: registry as {
+			[K in T[number]['meta']['name']]: Extract<T[number], { meta: { name: K } }>['server']
+		}
+	};
+}

package/backend/lib/mcp/servers/index.ts

@@ -1,45 +1,45 @@
-/**
- * MCP Servers Registry
- *
- * This file exports all custom MCP server implementations and provides
- * a type-safe registry for server configuration.
- *
- * To add a new server:
- * 1. Create your server file (e.g., ./my-server.ts) using defineServer
- * 2. Import it and add to the allServers array below
- * 3. Done! Registries are auto-built and type-safe.
- */
-
-import weather from './weather/index';
-import browserAutomation from './browser-automation/index';
-import { buildServerRegistries } from './helper';
-
-// Re-export types for stdio server
-export type { RawToolDef } from './helper';
-
-/**
- * All MCP Servers
- *
- * Simply import and add new servers to this array.
- * Metadata and registry will be automatically built.
- */
-const allServers = [
-	weather,
-	browserAutomation,
-	// Add more servers here...
-] as const;
-
-/**
- * Auto-build registries from server array
- */
-const { metadata, registry } = buildServerRegistries(allServers);
-
-/**
- * Server Metadata Registry - Defines available servers and their tools
- */
-export const serverMetadata = metadata;
-
-/**
- * Server Instance Registry - Maps server names to SDK instances
- */
+/**
+ * MCP Servers Registry
+ *
+ * This file exports all custom MCP server implementations and provides
+ * a type-safe registry for server configuration.
+ *
+ * To add a new server:
+ * 1. Create your server file (e.g., ./my-server.ts) using defineServer
+ * 2. Import it and add to the allServers array below
+ * 3. Done! Registries are auto-built and type-safe.
+ */
+
+import weather from './weather/index';
+import browserAutomation from './browser-automation/index';
+import { buildServerRegistries } from './helper';
+
+// Re-export types for stdio server
+export type { RawToolDef } from './helper';
+
+/**
+ * All MCP Servers
+ *
+ * Simply import and add new servers to this array.
+ * Metadata and registry will be automatically built.
+ */
+const allServers = [
+	weather,
+	browserAutomation,
+	// Add more servers here...
+] as const;
+
+/**
+ * Auto-build registries from server array
+ */
+const { metadata, registry } = buildServerRegistries(allServers);
+
+/**
+ * Server Metadata Registry - Defines available servers and their tools
+ */
+export const serverMetadata = metadata;
+
+/**
+ * Server Instance Registry - Maps server names to SDK instances
+ */
 export const serverRegistry = registry;

package/backend/lib/mcp/servers/weather/get-temperature.ts

@@ -1,56 +1,56 @@
-/**
- * Get Temperature Handler
- */
-
-export async function getTemperatureHandler(args: { latitude: number; longitude: number }) {
-	try {
-		// Call Open-Meteo API (no API key required)
-		const url = `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&current=temperature_2m&temperature_unit=fahrenheit`;
-
-		const response = await fetch(url);
-
-		if (!response.ok) {
-			return {
-				content: [{
-					type: "text" as const,
-					text: `Failed to fetch weather data: ${response.status} ${response.statusText}`
-				}],
-				isError: true
-			};
-		}
-
-		const data = await response.json();
-
-		// Check if temperature data is available
-		if (!data.current || data.current.temperature_2m === undefined) {
-			return {
-				content: [{
-					type: "text" as const,
-					text: "Temperature data not available for this location."
-				}],
-				isError: true
-			};
-		}
-
-		const temperature = data.current.temperature_2m;
-		const unit = data.current_units?.temperature_2m || "°F";
-
-		return {
-			content: [{
-				type: "text" as const,
-				text: `Temperature: ${temperature}${unit}`
-			}]
-		};
-
-	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-
-		return {
-			content: [{
-				type: "text" as const,
-				text: `Error fetching temperature: ${errorMessage}`
-			}],
-			isError: true
-		};
-	}
-}
+/**
+ * Get Temperature Handler
+ */
+
+export async function getTemperatureHandler(args: { latitude: number; longitude: number }) {
+	try {
+		// Call Open-Meteo API (no API key required)
+		const url = `https://api.open-meteo.com/v1/forecast?latitude=${args.latitude}&longitude=${args.longitude}&current=temperature_2m&temperature_unit=fahrenheit`;
+
+		const response = await fetch(url);
+
+		if (!response.ok) {
+			return {
+				content: [{
+					type: "text" as const,
+					text: `Failed to fetch weather data: ${response.status} ${response.statusText}`
+				}],
+				isError: true
+			};
+		}
+
+		const data = await response.json();
+
+		// Check if temperature data is available
+		if (!data.current || data.current.temperature_2m === undefined) {
+			return {
+				content: [{
+					type: "text" as const,
+					text: "Temperature data not available for this location."
+				}],
+				isError: true
+			};
+		}
+
+		const temperature = data.current.temperature_2m;
+		const unit = data.current_units?.temperature_2m || "°F";
+
+		return {
+			content: [{
+				type: "text" as const,
+				text: `Temperature: ${temperature}${unit}`
+			}]
+		};
+
+	} catch (error) {
+		const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+
+		return {
+			content: [{
+				type: "text" as const,
+				text: `Error fetching temperature: ${errorMessage}`
+			}],
+			isError: true
+		};
+	}
+}

package/backend/lib/mcp/servers/weather/index.ts

@@ -1,31 +1,31 @@
-/**
- * Weather Service - Custom MCP Server
- *
- * Provides weather-related tools using the Open-Meteo API.
- * No API key required.
- */
-
-import { z } from "zod";
-import { defineServer } from "../helper";
-import { getTemperatureHandler } from "./get-temperature";
-
-export default defineServer({
-	name: "weather-service",
-	version: "1.0.0",
-	tools: {
-		"get_temperature": {
-			description: "Get current temperature for a location using coordinates. Returns temperature in Fahrenheit.",
-			schema: {
-				latitude: z.number()
-					.min(-90)
-					.max(90)
-					.describe("Latitude coordinate (-90 to 90)"),
-				longitude: z.number()
-					.min(-180)
-					.max(180)
-					.describe("Longitude coordinate (-180 to 180)")
-			},
-			handler: getTemperatureHandler
-		}
-	}
-});
+/**
+ * Weather Service - Custom MCP Server
+ *
+ * Provides weather-related tools using the Open-Meteo API.
+ * No API key required.
+ */
+
+import { z } from "zod";
+import { defineServer } from "../helper";
+import { getTemperatureHandler } from "./get-temperature";
+
+export default defineServer({
+	name: "weather-service",
+	version: "1.0.0",
+	tools: {
+		"get_temperature": {
+			description: "Get current temperature for a location using coordinates. Returns temperature in Fahrenheit.",
+			schema: {
+				latitude: z.number()
+					.min(-90)
+					.max(90)
+					.describe("Latitude coordinate (-90 to 90)"),
+				longitude: z.number()
+					.min(-180)
+					.max(180)
+					.describe("Longitude coordinate (-180 to 180)")
+			},
+			handler: getTemperatureHandler
+		}
+	}
+});