@theyahia/mcp-core 1.0.0

package/dist/testing/smoke.js

@@ -0,0 +1,79 @@
+/**
+ * Shared E2E smoke test utilities for MCP servers.
+ *
+ * Uses StdioClientTransport from the MCP SDK to connect to a compiled
+ * server binary and verify it starts, lists tools, and has quality descriptions.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+/**
+ * Runs a smoke test against a compiled MCP server.
+ *
+ * 1. Spawns the server via StdioClientTransport
+ * 2. Connects and sends initialize
+ * 3. Lists tools and validates descriptions
+ * 4. Closes cleanly
+ */
+export async function runSmokeTest(config) {
+    const errors = [];
+    const timeout = config.timeout ?? 10_000;
+    const transport = new StdioClientTransport({
+        command: "node",
+        args: [config.serverPath],
+        env: {
+            ...process.env,
+            ...config.env,
+        },
+    });
+    const client = new Client({
+        name: "smoke-test",
+        version: "1.0.0",
+    });
+    try {
+        // Connect with timeout
+        await Promise.race([
+            client.connect(transport),
+            new Promise((_, reject) => setTimeout(() => reject(new Error("Connection timeout")), timeout)),
+        ]);
+        const { tools } = await client.listTools();
+        if (tools.length < config.expectedToolCount) {
+            errors.push(`Expected at least ${config.expectedToolCount} tools, got ${tools.length}`);
+        }
+        const toolResults = tools.map((tool) => {
+            const desc = tool.description ?? "";
+            if (desc.length < 20) {
+                errors.push(`Tool "${tool.name}" has short description (${desc.length} chars). Minimum recommended: 20.`);
+            }
+            return {
+                name: tool.name,
+                description: desc,
+                descriptionLength: desc.length,
+                hasInputSchema: !!tool.inputSchema,
+            };
+        });
+        await client.close();
+        return {
+            connected: true,
+            toolCount: tools.length,
+            tools: toolResults,
+            errors,
+        };
+    }
+    catch (error) {
+        try {
+            await client.close();
+        }
+        catch {
+            // ignore close errors
+        }
+        return {
+            connected: false,
+            toolCount: 0,
+            tools: [],
+            errors: [
+                error instanceof Error ? error.message : String(error),
+            ],
+        };
+    }
+}
+//# sourceMappingURL=smoke.js.map

package/dist/testing/smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.js","sourceRoot":"","sources":["../../src/testing/smoke.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAyBjF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAuB;IAEvB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;IAEzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;QACzB,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,GAAG,MAAM,CAAC,GAAG;SACY;KAC5B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,uBAAuB;QACvB,MAAM,OAAO,CAAC,IAAI,CAAC;YACjB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YACzB,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CACxB,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,CACnE;SACF,CAAC,CAAC;QAEH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;QAE3C,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CACT,qBAAqB,MAAM,CAAC,iBAAiB,eAAe,KAAK,CAAC,MAAM,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACrB,MAAM,CAAC,IAAI,CACT,SAAS,IAAI,CAAC,IAAI,4BAA4B,IAAI,CAAC,MAAM,mCAAmC,CAC7F,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI;gBACjB,iBAAiB,EAAE,IAAI,CAAC,MAAM;gBAC9B,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW;aACnC,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO;YACL,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,KAAK,EAAE,WAAW;YAClB,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;QACD,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,CAAC;YACZ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE;gBACN,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aACvD;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@theyahia/mcp-core",
+  "version": "1.0.0",
+  "description": "Shared core library for @theyahia MCP servers — client, auth, errors, formatting, logging, CLI, server factory",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
+    },
+    "./format": {
+      "types": "./dist/format.d.ts",
+      "default": "./dist/format.js"
+    },
+    "./logging": {
+      "types": "./dist/logging.d.ts",
+      "default": "./dist/logging.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "default": "./dist/auth/index.js"
+    },
+    "./testing/smoke": {
+      "types": "./dist/testing/smoke.d.ts",
+      "default": "./dist/testing/smoke.js"
+    },
+    "./testing/smoke.js": {
+      "types": "./dist/testing/smoke.d.ts",
+      "default": "./dist/testing/smoke.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "optionalDependencies": {
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/theYahia/mcp-servers.git",
+    "directory": "packages/core"
+  },
+  "author": "theYahia (https://github.com/theYahia)",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}