@yawlabs/mcp-compliance 0.2.1 → 0.3.0

package/dist/mcp/server.js

@@ -1,12 +1,12 @@
 import {
   TEST_DEFINITIONS,
   runComplianceSuite
-} from "../chunk-SP24UFRC.js";
+} from "../chunk-U66YZGE5.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";
@@ -15,11 +15,32 @@ function registerTools(server2) {
     "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}`,
@@ -59,25 +80,42 @@ ${JSON.stringify(report, null, 2)}` }
     "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)")
+    },
+    {
+      title: "Get Compliance Badge",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
     },
-    async ({ url }) => {
+    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 {
@@ -93,33 +131,44 @@ ${JSON.stringify(report, null, 2)}` }
     {
       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
+            ].join("\n")
+          }
+        ]
       };
     }
   );

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;
@@ -66,7 +66,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-U66YZGE5.js";
 export {
   TEST_DEFINITIONS,
   computeGrade,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcp-compliance",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI tool and MCP server that tests MCP servers for spec compliance",
   "license": "MIT",
   "author": "Yaw Labs (https://yaw.sh)",
@@ -24,7 +24,10 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "vitest run",
-    "lint": "tsc --noEmit",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "typecheck": "tsc --noEmit",
+    "test:ci": "npm run build && npm test",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
@@ -35,6 +38,7 @@
     "zod": "^3.24.4"
   },
   "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
     "@types/node": "^25.5.2",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
@@ -52,7 +56,10 @@
   ],
   "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"
 }