@yawlabs/mcp-compliance 0.3.0 → 0.5.0

package/dist/mcp/server.d.ts

@@ -1,2 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
-export {  }
+/**
+ * Create and configure the MCP compliance server instance.
+ */
+declare function createComplianceServer(): McpServer;
+/**
+ * Start the MCP compliance server with stdio transport.
+ */
+declare function startServer(): Promise<void>;
+
+export { createComplianceServer, startServer };

package/dist/mcp/server.js

@@ -1,7 +1,8 @@
 import {
+  SPEC_BASE,
   TEST_DEFINITIONS,
   runComplianceSuite
-} from "../chunk-U66YZGE5.js";
+} from "../chunk-Z7VLPYIO.js";
 
 // src/mcp/server.ts
 import { createRequire } from "module";
@@ -10,10 +11,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 
 // src/mcp/tools.ts
 import { z } from "zod";
-function registerTools(server2) {
-  server2.tool(
+function registerTools(server) {
+  server.tool(
     "mcp_compliance_test",
-    "Run the full MCP compliance test suite against a server URL. Returns grade (A-F), score, and detailed results for all 43 tests covering transport, lifecycle, tools, resources, prompts, errors, and schema validation.",
+    "Run the full MCP compliance test suite against a server URL. Returns grade (A-F), score, and detailed results for all 48 tests covering transport, lifecycle, tools, resources, prompts, errors, and schema validation.",
     {
       url: z.string().url().describe("The MCP server URL to test (must be HTTP or HTTPS)"),
       auth: z.string().optional().describe('Authorization header value (e.g., "Bearer tok123")'),
@@ -69,14 +70,15 @@ ${JSON.stringify(report, null, 2)}` }
           ]
         };
       } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
         return {
-          content: [{ type: "text", text: `Error running compliance test: ${err.message}` }],
+          content: [{ type: "text", text: `Error running compliance test: ${message}` }],
           isError: true
         };
       }
     }
   );
-  server2.tool(
+  server.tool(
     "mcp_compliance_badge",
     "Get the badge markdown embed code for an MCP server. Runs the compliance test suite first to determine the grade.",
     {
@@ -118,14 +120,15 @@ ${JSON.stringify(report, null, 2)}` }
           ]
         };
       } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
         return {
-          content: [{ type: "text", text: `Error: ${err.message}` }],
+          content: [{ type: "text", text: `Error: ${message}` }],
           isError: true
         };
       }
     }
   );
-  server2.tool(
+  server.tool(
     "mcp_compliance_explain",
     "Explain what a specific compliance test ID checks and why it matters.",
     {
@@ -163,9 +166,11 @@ ${TEST_DEFINITIONS.map((t) => t.id).join(", ")}`
               `Name: ${def.name}`,
               `Category: ${def.category}`,
               `Required: ${def.required ? "Yes" : "No"}`,
-              `Spec reference: https://modelcontextprotocol.io/specification/2025-11-25/${def.specRef}`,
+              `Spec reference: ${SPEC_BASE}/${def.specRef}`,
               "",
-              def.description
+              def.description,
+              "",
+              `Fix: ${def.recommendation}`
             ].join("\n")
           }
         ]
@@ -177,13 +182,24 @@ ${TEST_DEFINITIONS.map((t) => t.id).join(", ")}`
 // src/mcp/server.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../../package.json");
-var server = new McpServer({ name: "mcp-compliance", version });
-registerTools(server);
-async function main() {
+function createComplianceServer() {
+  const server = new McpServer({ name: "mcp-compliance", version });
+  registerTools(server);
+  return server;
+}
+async function startServer() {
+  const server = createComplianceServer();
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
-main().catch((err) => {
-  console.error("MCP server error:", err);
-  process.exit(1);
-});
+var isDirectRun = process.argv[1]?.endsWith("mcp/server.js") || process.argv[1]?.endsWith("mcp\\server.js");
+if (isDirectRun) {
+  startServer().catch((err) => {
+    console.error("MCP server error:", err);
+    process.exit(1);
+  });
+}
+export {
+  createComplianceServer,
+  startServer
+};

package/dist/runner.d.ts

@@ -58,8 +58,9 @@ interface TestDefinition {
     required: boolean;
     specRef: string;
     description: string;
+    recommendation: string;
 }
-/** All 43 test IDs with descriptions for the explain command */
+/** All 48 test IDs with descriptions for the explain command */
 declare const TEST_DEFINITIONS: TestDefinition[];
 
 declare function computeGrade(score: number): Grade;
@@ -91,6 +92,16 @@ declare function generateBadge(url: string): {
     html: string;
 };
 
+declare const SPEC_VERSION = "2025-11-25";
+declare const SPEC_BASE = "https://modelcontextprotocol.io/specification/2025-11-25";
+/**
+ * Parse SSE (text/event-stream) response body.
+ * Handles multi-line data fields per the SSE specification:
+ * consecutive "data:" lines are concatenated with "\n".
+ * An empty line marks the end of an event.
+ * @internal Exported for testing.
+ */
+declare function parseSSEResponse(text: string): any;
 interface RunOptions {
     /** Optional callback for progress updates */
     onProgress?: (testId: string, passed: boolean, details: string) => void;
@@ -110,4 +121,4 @@ interface RunOptions {
  */
 declare function runComplianceSuite(url: string, options?: RunOptions): Promise<ComplianceReport>;
 
-export { type ComplianceReport, type RunOptions, TEST_DEFINITIONS, type TestResult, computeGrade, computeScore, generateBadge, runComplianceSuite };
+export { type ComplianceReport, type RunOptions, SPEC_BASE, SPEC_VERSION, TEST_DEFINITIONS, type TestResult, computeGrade, computeScore, generateBadge, parseSSEResponse, runComplianceSuite };

package/dist/runner.js

@@ -1,14 +1,20 @@
 import {
+  SPEC_BASE,
+  SPEC_VERSION,
   TEST_DEFINITIONS,
   computeGrade,
   computeScore,
   generateBadge,
+  parseSSEResponse,
   runComplianceSuite
-} from "./chunk-U66YZGE5.js";
+} from "./chunk-Z7VLPYIO.js";
 export {
+  SPEC_BASE,
+  SPEC_VERSION,
   TEST_DEFINITIONS,
   computeGrade,
   computeScore,
   generateBadge,
+  parseSSEResponse,
   runComplianceSuite
 };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@yawlabs/mcp-compliance",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "CLI tool and MCP server that tests MCP servers for spec compliance",
   "license": "MIT",
-  "author": "Yaw Labs (https://yaw.sh)",
+  "author": "Yaw Labs <contact@yaw.sh> (https://yaw.sh)",
   "type": "module",
   "exports": {
     ".": {
@@ -18,7 +18,9 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "!dist/**/*.test.*",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup",
@@ -28,7 +30,8 @@
     "lint:fix": "biome check --write src/",
     "typecheck": "tsc --noEmit",
     "test:ci": "npm run build && npm test",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -52,7 +55,12 @@
     "model-context-protocol",
     "compliance",
     "testing",
-    "cli"
+    "cli",
+    "mcp-server",
+    "spec",
+    "validation",
+    "json-rpc",
+    "ai"
   ],
   "repository": {
     "type": "git",