magus-cli 0.0.0-placeholder → 7.1.0

package/src/services/mcp-registry.ts

@@ -0,0 +1,171 @@
+import type {
+	McpRegistryResponse,
+	McpRegistryServer,
+	McpServer,
+} from "../types/index.js";
+
+const DEFAULT_MCP_REGISTRY_API =
+	"https://us-central1-claudish-6da10.cloudfunctions.net/mcpRegistry";
+
+export interface SearchOptions {
+	query?: string;
+	limit?: number;
+	cursor?: string;
+	signal?: AbortSignal;
+}
+
+function getMcpRegistryApiUrl(): string {
+	return (process.env.MCP_REGISTRY_API_URL || DEFAULT_MCP_REGISTRY_API).replace(
+		/\/+$/,
+		"",
+	);
+}
+
+function isOptionalString(value: unknown): value is string | undefined {
+	return value === undefined || typeof value === "string";
+}
+
+function isMcpRegistryServer(value: unknown): value is McpRegistryServer {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+
+	const server = value as Record<string, unknown>;
+	return (
+		typeof server.name === "string" &&
+		server.name.length > 0 &&
+		typeof server.url === "string" &&
+		server.url.length > 0 &&
+		typeof server.short_description === "string" &&
+		isOptionalString(server.version) &&
+		isOptionalString(server.source_code_url) &&
+		isOptionalString(server.package_registry) &&
+		isOptionalString(server.published_at)
+	);
+}
+
+function isMcpServer(value: unknown): value is McpServer {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const server = value as Record<string, unknown>;
+	const isHttp = server.type === "http";
+	return (
+		typeof server.name === "string" &&
+		server.name.length > 0 &&
+		typeof server.description === "string" &&
+		typeof server.category === "string" &&
+		(isHttp
+			? typeof server.url === "string" && server.url.length > 0
+			: typeof server.command === "string" && server.command.length > 0) &&
+		(server.args === undefined ||
+			(Array.isArray(server.args) &&
+				server.args.every((arg) => typeof arg === "string"))) &&
+		(server.env === undefined ||
+			(typeof server.env === "object" && !Array.isArray(server.env))) &&
+		(server.configFields === undefined || Array.isArray(server.configFields))
+	);
+}
+
+function parseMcpRegistryResponse(value: unknown): McpRegistryResponse {
+	if (!value || typeof value !== "object" || Array.isArray(value)) {
+		throw new Error("MCP Registry API returned a malformed response");
+	}
+
+	const response = value as Record<string, unknown>;
+	if (
+		!Array.isArray(response.servers) ||
+		!response.servers.every(isMcpRegistryServer) ||
+		!isOptionalString(response.next_cursor)
+	) {
+		throw new Error("MCP Registry API returned a malformed response");
+	}
+
+	return {
+		servers: response.servers,
+		...(response.next_cursor === undefined
+			? {}
+			: { next_cursor: response.next_cursor }),
+	};
+}
+
+export async function searchMcpServers(
+	options: SearchOptions = {},
+): Promise<McpRegistryResponse> {
+	const { query = "", limit = 20, cursor, signal } = options;
+
+	const params = new URLSearchParams();
+	if (query) params.set("q", query);
+	params.set("limit", String(limit));
+	if (cursor) params.set("cursor", cursor);
+
+	const url = `${getMcpRegistryApiUrl()}/search?${params.toString()}`;
+
+	const response = await fetch(url, {
+		headers: {
+			Accept: "application/json",
+		},
+		signal,
+	});
+
+	if (!response.ok) {
+		throw new Error(
+			`MCP Registry API error: ${response.status} ${response.statusText}`,
+		);
+	}
+
+	let data: unknown;
+	try {
+		data = await response.json();
+	} catch {
+		throw new Error("MCP Registry API returned a malformed response");
+	}
+
+	return parseMcpRegistryResponse(data);
+}
+
+export async function getPopularServers(
+	limit = 20,
+): Promise<McpRegistryServer[]> {
+	const response = await searchMcpServers({ limit });
+	return response.servers;
+}
+
+/** Fetch the install-ready catalog. This is separate from dynamic Registry search. */
+export async function fetchCuratedMcpServers(
+	signal?: AbortSignal,
+): Promise<McpServer[]> {
+	const response = await fetch(`${getMcpRegistryApiUrl()}/recommended`, {
+		headers: { Accept: "application/json" },
+		signal,
+	});
+	if (!response.ok) {
+		throw new Error(`MCP catalog API error: ${response.status}`);
+	}
+
+	let data: unknown;
+	try {
+		data = await response.json();
+	} catch {
+		throw new Error("MCP catalog API returned a malformed response");
+	}
+	if (!data || typeof data !== "object" || Array.isArray(data)) {
+		throw new Error("MCP catalog API returned a malformed response");
+	}
+	const servers = (data as Record<string, unknown>).servers;
+	if (!Array.isArray(servers) || !servers.every(isMcpServer)) {
+		throw new Error("MCP catalog API returned a malformed response");
+	}
+	return servers;
+}
+
+export function formatDate(dateStr?: string): string {
+	if (!dateStr) return "";
+	const date = new Date(dateStr);
+	const now = new Date();
+	const diffMs = now.getTime() - date.getTime();
+	const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+
+	if (diffDays === 0) return "today";
+	if (diffDays === 1) return "yesterday";
+	if (diffDays < 7) return `${diffDays}d ago`;
+	if (diffDays < 30) return `${Math.floor(diffDays / 7)}w ago`;
+	if (diffDays < 365) return `${Math.floor(diffDays / 30)}mo ago`;
+	return `${Math.floor(diffDays / 365)}y ago`;
+}