@withpica/mcp-server-directory 1.0.0 → 1.1.0

package/src/utils/errors.ts

@@ -0,0 +1,64 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+
+export class McpServerError extends Error {
+  constructor(
+    message: string,
+    public code: string,
+    public details?: any,
+  ) {
+    super(message);
+    this.name = "McpServerError";
+    Object.setPrototypeOf(this, McpServerError.prototype);
+  }
+}
+
+export class ToolExecutionError extends McpServerError {
+  constructor(message: string, details?: any) {
+    super(message, "TOOL_EXECUTION_ERROR", details);
+    this.name = "ToolExecutionError";
+  }
+}
+
+export function formatError(error: any): { type: string; text: string } {
+  if (error instanceof McpServerError) {
+    return {
+      type: "text",
+      text: JSON.stringify(
+        { error: error.code, message: error.message, details: error.details },
+        null,
+        2,
+      ),
+    };
+  }
+
+  if (error instanceof Error) {
+    return {
+      type: "text",
+      text: JSON.stringify(
+        { error: "UNKNOWN_ERROR", message: error.message },
+        null,
+        2,
+      ),
+    };
+  }
+
+  return {
+    type: "text",
+    text: JSON.stringify(
+      { error: "UNKNOWN_ERROR", message: String(error) },
+      null,
+      2,
+    ),
+  };
+}
+
+export function logError(context: string, error: any): void {
+  const entry: Record<string, unknown> = {
+    level: "error",
+    context,
+    message: error instanceof Error ? error.message : String(error),
+    timestamp: new Date().toISOString(),
+  };
+  if (error instanceof Error && error.stack) entry.stack = error.stack;
+  console.error(JSON.stringify(entry));
+}

package/src/utils/formatting.ts

@@ -0,0 +1,28 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+
+export interface FormattedResult {
+  content: Array<{ type: string; text: string }>;
+  structuredContent?: Record<string, unknown>;
+}
+
+export function formatAsText(data: any): FormattedResult {
+  return {
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    structuredContent: data as Record<string, unknown>,
+  };
+}
+
+export function formatStructuredList<T>(
+  items: T[],
+  entityName: string,
+  metadata?: Record<string, any>,
+): FormattedResult {
+  const count = items.length;
+  const summary = `Found ${count} ${entityName}${count !== 1 ? "s" : ""}${
+    metadata?.query ? ` matching "${metadata.query}"` : ""
+  }.`;
+  return {
+    content: [{ type: "text", text: summary }],
+    structuredContent: { count, items, ...metadata } as Record<string, unknown>,
+  };
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "isolatedModules": true,
+    "types": ["node", "jest"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "src/__tests__"]
+}