@yawlabs/mcp-compliance 0.2.0 → 0.2.1

package/dist/index.js

@@ -1095,7 +1095,125 @@ function formatJson(report) {
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/mcp/tools.ts
 import { z } from "zod";
+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)")
+    },
+    async ({ url }) => {
+      try {
+        const report = await runComplianceSuite(url);
+        const summary = [
+          `Grade: ${report.grade} (${report.score}%)`,
+          `Overall: ${report.overall}`,
+          `Tests: ${report.summary.passed}/${report.summary.total} passed (${report.summary.requiredPassed}/${report.summary.required} required)`,
+          "",
+          ...report.tests.map(
+            (t) => `${t.passed ? "PASS" : "FAIL"} ${t.name}${t.required ? " (required)" : ""} \u2014 ${t.details}`
+          )
+        ];
+        if (report.serverInfo.name) {
+          summary.unshift(`Server: ${report.serverInfo.name} v${report.serverInfo.version || "?"}`);
+        }
+        if (report.warnings.length > 0) {
+          summary.push("", `Warnings (${report.warnings.length}):`);
+          for (const w of report.warnings) {
+            summary.push(`  - ${w}`);
+          }
+        }
+        return {
+          content: [
+            { type: "text", text: summary.join("\n") },
+            { type: "text", text: `
+
+Full report:
+${JSON.stringify(report, null, 2)}` }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error running compliance test: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  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")
+    },
+    async ({ url }) => {
+      try {
+        const report = await runComplianceSuite(url);
+        const badge = report.badge;
+        return {
+          content: [{
+            type: "text",
+            text: [
+              `Grade: ${report.grade} (${report.score}%)`,
+              "",
+              "Markdown:",
+              badge.markdown,
+              "",
+              "HTML:",
+              badge.html
+            ].join("\n")
+          }]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  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")')
+    },
+    async ({ testId }) => {
+      const def = TEST_DEFINITIONS.find((t) => t.id === testId);
+      if (!def) {
+        return {
+          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")
+        }]
+      };
+    }
+  );
+}
+
+// src/index.ts
 var require2 = createRequire2(import.meta.url);
 var { version } = require2("../package.json");
 function parseHeaderArg(value, prev) {
@@ -1179,85 +1297,7 @@ Error: ${err.message}
 });
 program.command("mcp").description("Start the MCP compliance server (stdio transport)").action(async () => {
   const server = new McpServer({ name: "mcp-compliance", version });
-  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)") },
-    async ({ url }) => {
-      try {
-        const report = await runComplianceSuite(url);
-        const summary = [
-          `Grade: ${report.grade} (${report.score}%)`,
-          `Overall: ${report.overall}`,
-          `Tests: ${report.summary.passed}/${report.summary.total} passed (${report.summary.requiredPassed}/${report.summary.required} required)`,
-          "",
-          ...report.tests.map(
-            (t) => `${t.passed ? "PASS" : "FAIL"} ${t.name}${t.required ? " (required)" : ""} \u2014 ${t.details}`
-          )
-        ];
-        if (report.serverInfo.name) {
-          summary.unshift(`Server: ${report.serverInfo.name} v${report.serverInfo.version || "?"}`);
-        }
-        if (report.warnings.length > 0) {
-          summary.push("", `Warnings (${report.warnings.length}):`);
-          for (const w of report.warnings) summary.push(`  - ${w}`);
-        }
-        return {
-          content: [
-            { type: "text", text: summary.join("\n") },
-            { type: "text", text: `
-
-Full report:
-${JSON.stringify(report, null, 2)}` }
-          ]
-        };
-      } catch (err) {
-        return { content: [{ type: "text", text: `Error running compliance test: ${err.message}` }], isError: true };
-      }
-    }
-  );
-  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") },
-    async ({ url }) => {
-      try {
-        const report = await runComplianceSuite(url);
-        const badge = report.badge;
-        return {
-          content: [{
-            type: "text",
-            text: [`Grade: ${report.grade} (${report.score}%)`, "", "Markdown:", badge.markdown, "", "HTML:", badge.html].join("\n")
-          }]
-        };
-      } catch (err) {
-        return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
-      }
-    }
-  );
-  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")') },
-    async ({ testId }) => {
-      const def = TEST_DEFINITIONS.find((t) => t.id === testId);
-      if (!def) {
-        return {
-          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")
-        }]
-      };
-    }
-  );
+  registerTools(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 });

package/dist/mcp/server.js

@@ -6,127 +6,130 @@ import {
 // src/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
 import { createRequire } from "module";
-var require2 = createRequire(import.meta.url);
-var { version } = require2("../../package.json");
-var server = new McpServer({
-  name: "mcp-compliance",
-  version
-});
-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)")
-  },
-  async ({ url }) => {
-    try {
-      const report = await runComplianceSuite(url);
-      const summary = [
-        `Grade: ${report.grade} (${report.score}%)`,
-        `Overall: ${report.overall}`,
-        `Tests: ${report.summary.passed}/${report.summary.total} passed (${report.summary.requiredPassed}/${report.summary.required} required)`,
-        "",
-        ...report.tests.map(
-          (t) => `${t.passed ? "PASS" : "FAIL"} ${t.name}${t.required ? " (required)" : ""} \u2014 ${t.details}`
-        )
-      ];
-      if (report.serverInfo.name) {
-        summary.unshift(`Server: ${report.serverInfo.name} v${report.serverInfo.version || "?"}`);
-      }
-      if (report.warnings.length > 0) {
-        summary.push("", `Warnings (${report.warnings.length}):`);
-        for (const w of report.warnings) {
-          summary.push(`  - ${w}`);
+
+// src/mcp/tools.ts
+import { z } from "zod";
+function registerTools(server2) {
+  server2.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)")
+    },
+    async ({ url }) => {
+      try {
+        const report = await runComplianceSuite(url);
+        const summary = [
+          `Grade: ${report.grade} (${report.score}%)`,
+          `Overall: ${report.overall}`,
+          `Tests: ${report.summary.passed}/${report.summary.total} passed (${report.summary.requiredPassed}/${report.summary.required} required)`,
+          "",
+          ...report.tests.map(
+            (t) => `${t.passed ? "PASS" : "FAIL"} ${t.name}${t.required ? " (required)" : ""} \u2014 ${t.details}`
+          )
+        ];
+        if (report.serverInfo.name) {
+          summary.unshift(`Server: ${report.serverInfo.name} v${report.serverInfo.version || "?"}`);
         }
-      }
-      return {
-        content: [
-          { type: "text", text: summary.join("\n") },
-          { type: "text", text: `
+        if (report.warnings.length > 0) {
+          summary.push("", `Warnings (${report.warnings.length}):`);
+          for (const w of report.warnings) {
+            summary.push(`  - ${w}`);
+          }
+        }
+        return {
+          content: [
+            { type: "text", text: summary.join("\n") },
+            { type: "text", text: `
 
 Full report:
 ${JSON.stringify(report, null, 2)}` }
-        ]
-      };
-    } catch (err) {
-      return {
-        content: [{ type: "text", text: `Error running compliance test: ${err.message}` }],
-        isError: true
-      };
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error running compliance test: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server2.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")
+    },
+    async ({ url }) => {
+      try {
+        const report = await runComplianceSuite(url);
+        const badge = report.badge;
+        return {
+          content: [{
+            type: "text",
+            text: [
+              `Grade: ${report.grade} (${report.score}%)`,
+              "",
+              "Markdown:",
+              badge.markdown,
+              "",
+              "HTML:",
+              badge.html
+            ].join("\n")
+          }]
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Error: ${err.message}` }],
+          isError: true
+        };
+      }
     }
-  }
-);
-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")
-  },
-  async ({ url }) => {
-    try {
-      const report = await runComplianceSuite(url);
-      const badge = report.badge;
+  );
+  server2.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")')
+    },
+    async ({ testId }) => {
+      const def = TEST_DEFINITIONS.find((t) => t.id === testId);
+      if (!def) {
+        return {
+          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: [
-            `Grade: ${report.grade} (${report.score}%)`,
+            `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}`,
             "",
-            "Markdown:",
-            badge.markdown,
-            "",
-            "HTML:",
-            badge.html
+            def.description
           ].join("\n")
         }]
       };
-    } catch (err) {
-      return {
-        content: [{ type: "text", text: `Error: ${err.message}` }],
-        isError: true
-      };
     }
-  }
-);
-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")')
-  },
-  async ({ testId }) => {
-    const def = TEST_DEFINITIONS.find((t) => t.id === testId);
-    if (!def) {
-      const ids = TEST_DEFINITIONS.map((t) => t.id).join(", ");
-      return {
-        content: [{
-          type: "text",
-          text: `Unknown test ID: "${testId}"
+  );
+}
 
-Valid test IDs:
-${ids}`
-        }],
-        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")
-      }]
-    };
-  }
-);
+// 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() {
   const transport = new StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/mcp-compliance",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool and MCP server that tests MCP servers for spec compliance",
   "license": "MIT",
   "author": "Yaw Labs (https://yaw.sh)",