@yawlabs/mcp-compliance 0.2.1 → 0.4.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,25 +1,46 @@
 import {
   TEST_DEFINITIONS,
   runComplianceSuite
-} from "../chunk-SP24UFRC.js";
+} from "../chunk-KNOSZ3TD.js";
 
 // src/mcp/server.ts
+import { createRequire } from "module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createRequire } from "module";
 
 // 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.",
     {
-      url: z.string().url().describe("The MCP server URL to test (must be HTTP or HTTPS)")
+      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")'),
+      headers: z.record(z.string()).optional().describe('Additional headers to include on all requests (e.g., {"X-Api-Key": "abc"})'),
+      timeout: z.number().optional().describe("Request timeout in milliseconds (default: 15000)"),
+      retries: z.number().optional().describe("Number of retries for failed tests (default: 0)"),
+      only: z.array(z.string()).optional().describe("Only run tests matching these categories or test IDs"),
+      skip: z.array(z.string()).optional().describe("Skip tests matching these categories or test IDs")
+    },
+    {
+      title: "Run MCP Compliance Tests",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
     },
-    async ({ url }) => {
+    async ({ url, auth, headers: extraHeaders, timeout, retries, only, skip }) => {
       try {
-        const report = await runComplianceSuite(url);
+        const headers = { ...extraHeaders };
+        if (auth) headers.Authorization = auth;
+        const report = await runComplianceSuite(url, {
+          headers: Object.keys(headers).length > 0 ? headers : void 0,
+          timeout,
+          retries,
+          only,
+          skip
+        });
         const summary = [
           `Grade: ${report.grade} (${report.score}%)`,
           `Overall: ${report.overall}`,
@@ -55,29 +76,46 @@ ${JSON.stringify(report, null, 2)}` }
       }
     }
   );
-  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.",
     {
-      url: z.string().url().describe("The MCP server URL to test")
+      url: z.string().url().describe("The MCP server URL to test"),
+      auth: z.string().optional().describe('Authorization header value (e.g., "Bearer tok123")'),
+      headers: z.record(z.string()).optional().describe("Additional headers to include on all requests"),
+      timeout: z.number().optional().describe("Request timeout in milliseconds (default: 15000)")
     },
-    async ({ url }) => {
+    {
+      title: "Get Compliance Badge",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    async ({ url, auth, headers: extraHeaders, timeout }) => {
       try {
-        const report = await runComplianceSuite(url);
+        const headers = { ...extraHeaders };
+        if (auth) headers.Authorization = auth;
+        const report = await runComplianceSuite(url, {
+          headers: Object.keys(headers).length > 0 ? headers : void 0,
+          timeout
+        });
         const badge = report.badge;
         return {
-          content: [{
-            type: "text",
-            text: [
-              `Grade: ${report.grade} (${report.score}%)`,
-              "",
-              "Markdown:",
-              badge.markdown,
-              "",
-              "HTML:",
-              badge.html
-            ].join("\n")
-          }]
+          content: [
+            {
+              type: "text",
+              text: [
+                `Grade: ${report.grade} (${report.score}%)`,
+                "",
+                "Markdown:",
+                badge.markdown,
+                "",
+                "HTML:",
+                badge.html
+              ].join("\n")
+            }
+          ]
         };
       } catch (err) {
         return {
@@ -87,39 +125,52 @@ ${JSON.stringify(report, null, 2)}` }
       }
     }
   );
-  server2.tool(
+  server.tool(
     "mcp_compliance_explain",
     "Explain what a specific compliance test ID checks and why it matters.",
     {
       testId: z.string().describe('The test ID to explain (e.g., "transport-post", "lifecycle-init", "tools-schema")')
     },
+    {
+      title: "Explain Compliance Test",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
     async ({ testId }) => {
       const def = TEST_DEFINITIONS.find((t) => t.id === testId);
       if (!def) {
         return {
-          content: [{
-            type: "text",
-            text: `Unknown test ID: "${testId}"
+          content: [
+            {
+              type: "text",
+              text: `Unknown test ID: "${testId}"
 
 Valid test IDs:
 ${TEST_DEFINITIONS.map((t) => t.id).join(", ")}`
-          }],
+            }
+          ],
           isError: true
         };
       }
       return {
-        content: [{
-          type: "text",
-          text: [
-            `Test: ${def.id}`,
-            `Name: ${def.name}`,
-            `Category: ${def.category}`,
-            `Required: ${def.required ? "Yes" : "No"}`,
-            `Spec reference: https://modelcontextprotocol.io/specification/2025-11-25/${def.specRef}`,
-            "",
-            def.description
-          ].join("\n")
-        }]
+        content: [
+          {
+            type: "text",
+            text: [
+              `Test: ${def.id}`,
+              `Name: ${def.name}`,
+              `Category: ${def.category}`,
+              `Required: ${def.required ? "Yes" : "No"}`,
+              `Spec reference: https://modelcontextprotocol.io/specification/2025-11-25/${def.specRef}`,
+              "",
+              def.description,
+              "",
+              `Fix: ${def.recommendation}`
+            ].join("\n")
+          }
+        ]
       };
     }
   );
@@ -128,13 +179,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

@@ -1,4 +1,4 @@
-type TestCategory = 'transport' | 'lifecycle' | 'tools' | 'resources' | 'prompts' | 'errors' | 'schema';
+type TestCategory = "transport" | "lifecycle" | "tools" | "resources" | "prompts" | "errors" | "schema";
 interface TestResult {
     id: string;
     name: string;
@@ -9,8 +9,8 @@ interface TestResult {
     durationMs: number;
     specRef?: string;
 }
-type Grade = 'A' | 'B' | 'C' | 'D' | 'F';
-type Overall = 'pass' | 'partial' | 'fail';
+type Grade = "A" | "B" | "C" | "D" | "F";
+type Overall = "pass" | "partial" | "fail";
 interface ComplianceReport {
     specVersion: string;
     toolVersion: string;
@@ -58,6 +58,7 @@ interface TestDefinition {
     required: boolean;
     specRef: string;
     description: string;
+    recommendation: string;
 }
 /** All 43 test IDs with descriptions for the explain command */
 declare const TEST_DEFINITIONS: TestDefinition[];
@@ -66,7 +67,7 @@ declare function computeGrade(score: number): Grade;
 declare function computeScore(tests: TestResult[]): {
     score: number;
     grade: Grade;
-    overall: 'pass' | 'partial' | 'fail';
+    overall: "pass" | "partial" | "fail";
     summary: {
         total: number;
         passed: number;

package/dist/runner.js

@@ -4,7 +4,7 @@ import {
   computeScore,
   generateBadge,
   runComplianceSuite
-} from "./chunk-SP24UFRC.js";
+} from "./chunk-KNOSZ3TD.js";
 export {
   TEST_DEFINITIONS,
   computeGrade,

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@yawlabs/mcp-compliance",
-  "version": "0.2.1",
+  "version": "0.4.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,14 +18,20 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "!dist/**/*.test.*",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "typecheck": "tsc --noEmit",
+    "test:ci": "npm run build && npm test",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -35,6 +41,7 @@
     "zod": "^3.24.4"
   },
   "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
     "@types/node": "^25.5.2",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
@@ -48,11 +55,19 @@
     "model-context-protocol",
     "compliance",
     "testing",
-    "cli"
+    "cli",
+    "mcp-server",
+    "spec",
+    "validation",
+    "json-rpc",
+    "ai"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/yawlabs/mcp-compliance.git"
+    "url": "git+https://github.com/YawLabs/mcp-compliance.git"
+  },
+  "bugs": {
+    "url": "https://github.com/YawLabs/mcp-compliance/issues"
   },
   "homepage": "https://mcp.hosting"
 }