wjttc 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 WolfeJam (James Wolfe)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# WJTTC MCP Certification
+
+**The FAF Foundation Testing Standard for MCP Servers**
+
+[![FAF Foundation](https://img.shields.io/badge/FAF-Foundation_Approved-FF8C00)](https://faf.one)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+> *"When brakes must work flawlessly, so must our MCP servers"*
+
+> *"TEST the TESTING"* — wolfejam
+
+---
+
+## What is WJTTC?
+
+WJTTC is a comprehensive 7-tier certification system for [Model Context Protocol](https://modelcontextprotocol.io) (MCP) servers. It validates implementations against the official specification with F1-inspired engineering rigor.
+
+**46 tests across 7 tiers:** Protocol Compliance, Capability Negotiation, Tool Integrity, Resource Management, Security Validation, Performance Benchmarks, and Integration Readiness.
+
+---
+
+## Certification Tiers
+
+**FAF-Aligned Scoring - The Michelin Star for Repos**
+
+| Tier | Score | Badge | Meaning |
+|------|-------|-------|---------|
+| Big Orange | 105% | 🍊 | *The Michelin Star - Perfection + Excellence* |
+| Trophy | 100% | 🏆 | Perfect MCP compliance |
+| Gold | 99%+ | 🥇 | Exceptional |
+| Silver | 95%+ | 🥈 | Top tier - Excellent |
+| Bronze | 85%+ | 🥉 | Strong - Production ready |
+| Green | 70%+ | 🟢 | Good - Solid foundation |
+| Yellow | 55%+ | 🟡 | Caution - Needs improvement |
+| Red | <55% | 🔴 | Critical - Major work needed |
+| White | 0% | 🤍 | Empty - No context |
+
+---
+
+## Quick Start
+
+```bash
+# Test any MCP server
+npx wjttc certify --mcp "npx your-mcp-server"
+
+# Example output:
+# 🍊 CERTIFICATION: BIG-ORANGE
+#    Score:  105/100
+#    Tests:  46/46 passed
+```
+
+---
+
+## Current Standings
+
+| Server | Score | Tier |
+|--------|-------|------|
+| claude-faf-mcp | 105% | 🍊 Big Orange |
+| @upstash/context7-mcp | 95% | 🥈 Silver |
+| @modelcontextprotocol/server-memory | 91% | 🥉 Bronze |
+| @modelcontextprotocol/server-filesystem | 86% | 🥉 Bronze |
+
+See [WJTTC-CERTIFIED.md](./WJTTC-CERTIFIED.md) for full certification records.
+
+---
+
+## Documentation
+
+**[SPECIFICATION.md](./SPECIFICATION.md)** — Complete specification including:
+
+- All 46 tests documented
+- CLI reference
+- GitHub Action usage
+- Scoring algorithm
+- FAQ
+
+---
+
+## GitHub Action
+
+```yaml
+- uses: wolfe-jam/wjttc-action@v1
+  with:
+    mcp-path: './dist/index.js'
+    tier: bronze
+```
+
+---
+
+## Links
+
+- [Full Specification](./SPECIFICATION.md)
+- [Certification Records](./WJTTC-CERTIFIED.md)
+- [MCP Protocol](https://modelcontextprotocol.io)
+- [FAF Ecosystem](https://faf.one)
+
+---
+
+## License
+
+MIT
+
+---
+
+*WJTTC - WolfeJam Technical & Testing Center*
+*FAF Foundation Testing Standard*

package/dist/badge.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WJTTC Badge Generator
+ * Generates shields.io compatible badge JSON
+ */
+import { TierLevel } from './certifier';
+interface BadgeInput {
+    score: number;
+    tier: TierLevel;
+}
+interface BadgeJSON {
+    schemaVersion: 1;
+    label: string;
+    message: string;
+    color: string;
+    namedLogo?: string;
+    logoColor?: string;
+}
+export declare class BadgeGenerator {
+    static generate(input: BadgeInput): BadgeJSON;
+    /**
+     * Generate a shields.io URL directly
+     */
+    static generateUrl(input: BadgeInput): string;
+    /**
+     * Generate markdown badge syntax
+     */
+    static generateMarkdown(input: BadgeInput, repoUrl?: string): string;
+    /**
+     * Generate HTML badge syntax
+     */
+    static generateHtml(input: BadgeInput, repoUrl?: string): string;
+}
+export {};
+//# sourceMappingURL=badge.d.ts.map

package/dist/badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../src/badge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,UAAU,SAAS;IACjB,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4BD,qBAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS;IAY7C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAM7C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAUpE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;CAWjE"}

package/dist/badge.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * WJTTC Badge Generator
+ * Generates shields.io compatible badge JSON
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BadgeGenerator = void 0;
+// FAF-Aligned Tier Colors
+const TIER_COLORS = {
+    'big-orange': 'FF8C00', // Deep Orange - The Michelin Star
+    'trophy': 'FFD700', // Gold
+    'gold': 'FFD700', // Gold
+    'silver': 'C0C0C0', // Silver
+    'bronze': 'CD7F32', // Bronze
+    'green': '00C853', // Green
+    'yellow': 'FFD600', // Yellow
+    'red': 'D50000', // Red
+    'white': 'FFFFFF', // White
+};
+// FAF-Aligned Tier Emojis
+const TIER_EMOJIS = {
+    'big-orange': '🍊',
+    'trophy': '🏆',
+    'gold': '🥇',
+    'silver': '🥈',
+    'bronze': '🥉',
+    'green': '🟢',
+    'yellow': '🟡',
+    'red': '🔴',
+    'white': '🤍',
+};
+class BadgeGenerator {
+    static generate(input) {
+        const emoji = TIER_EMOJIS[input.tier];
+        const color = TIER_COLORS[input.tier];
+        return {
+            schemaVersion: 1,
+            label: 'WJTTC',
+            message: `${emoji} ${input.tier} (${input.score}%)`,
+            color,
+        };
+    }
+    /**
+     * Generate a shields.io URL directly
+     */
+    static generateUrl(input) {
+        const badge = this.generate(input);
+        const encoded = encodeURIComponent(JSON.stringify(badge));
+        return `https://img.shields.io/endpoint?url=data:application/json,${encoded}`;
+    }
+    /**
+     * Generate markdown badge syntax
+     */
+    static generateMarkdown(input, repoUrl) {
+        const url = this.generateUrl(input);
+        const alt = `WJTTC ${input.tier}`;
+        if (repoUrl) {
+            return `[![${alt}](${url})](${repoUrl})`;
+        }
+        return `![${alt}](${url})`;
+    }
+    /**
+     * Generate HTML badge syntax
+     */
+    static generateHtml(input, repoUrl) {
+        const url = this.generateUrl(input);
+        const alt = `WJTTC ${input.tier}`;
+        const img = `<img src="${url}" alt="${alt}" />`;
+        if (repoUrl) {
+            return `<a href="${repoUrl}">${img}</a>`;
+        }
+        return img;
+    }
+}
+exports.BadgeGenerator = BadgeGenerator;
+//# sourceMappingURL=badge.js.map

package/dist/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge.js","sourceRoot":"","sources":["../src/badge.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAkBH,0BAA0B;AAC1B,MAAM,WAAW,GAA8B;IAC7C,YAAY,EAAE,QAAQ,EAAO,kCAAkC;IAC/D,QAAQ,EAAE,QAAQ,EAAW,OAAO;IACpC,MAAM,EAAE,QAAQ,EAAa,OAAO;IACpC,QAAQ,EAAE,QAAQ,EAAW,SAAS;IACtC,QAAQ,EAAE,QAAQ,EAAW,SAAS;IACtC,OAAO,EAAE,QAAQ,EAAY,QAAQ;IACrC,QAAQ,EAAE,QAAQ,EAAW,SAAS;IACtC,KAAK,EAAE,QAAQ,EAAc,MAAM;IACnC,OAAO,EAAE,QAAQ,EAAY,QAAQ;CACtC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,WAAW,GAA8B;IAC7C,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,MAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,KAAiB;QAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEtC,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,GAAG,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,IAAI;YACnD,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAiB;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,OAAO,6DAA6D,OAAO,EAAE,CAAC;IAChF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAiB,EAAE,OAAgB;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QAElC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,MAAM,GAAG,KAAK,GAAG,MAAM,OAAO,GAAG,CAAC;QAC3C,CAAC;QACD,OAAO,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAiB,EAAE,OAAgB;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC;QAElC,MAAM,GAAG,GAAG,aAAa,GAAG,UAAU,GAAG,MAAM,CAAC;QAEhD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,YAAY,OAAO,KAAK,GAAG,MAAM,CAAC;QAC3C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAjDD,wCAiDC"}

package/dist/certifier.d.ts

@@ -0,0 +1,63 @@
+/**
+ * WJTTC MCP Certifier
+ * Core certification engine - Dynamically loads and tests MCP servers
+ *
+ * Based on MCP Specification 2025-11-25
+ */
+export type TierLevel = 'big-orange' | 'trophy' | 'gold' | 'silver' | 'bronze' | 'green' | 'yellow' | 'red' | 'white';
+export interface CertifierOptions {
+    mcpPath: string;
+    tiers: number[];
+    performanceTargets: {
+        toolList: number;
+        toolCall: number;
+    };
+    strict: boolean;
+}
+export interface TierResult {
+    tier: number;
+    name: string;
+    passed: boolean;
+    passedTests: number;
+    totalTests: number;
+    failedTests: string[];
+    duration: number;
+}
+export interface CertificationResult {
+    score: number;
+    totalTests: number;
+    passedTests: number;
+    failedTests: number;
+    tierResults: TierResult[];
+    timestamp: string;
+}
+export declare class WJTTCCertifier {
+    private options;
+    private connection;
+    private tools;
+    private resources;
+    private prompts;
+    private capabilities;
+    private testDir;
+    constructor(options: CertifierOptions);
+    run(): Promise<CertificationResult>;
+    private connect;
+    private disconnect;
+    private listTools;
+    private listResources;
+    private listPrompts;
+    private readResource;
+    private getPrompt;
+    private callTool;
+    private runTier;
+    private calculateScore;
+    private getTestsForTier;
+    private getTier1Tests;
+    private getTier2Tests;
+    private getTier3Tests;
+    private getTier4Tests;
+    private getTier5Tests;
+    private getTier6Tests;
+    private getTier7Tests;
+}
+//# sourceMappingURL=certifier.d.ts.map

package/dist/certifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certifier.d.ts","sourceRoot":"","sources":["../src/certifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEtH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kBAAkB,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAoCD,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,YAAY,CAKlB;IACF,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,EAAE,gBAAgB;IAI/B,GAAG,IAAI,OAAO,CAAC,mBAAmB,CAAC;YAqD3B,OAAO;IA4HrB,OAAO,CAAC,UAAU;YAKJ,SAAS;YAQT,aAAa;YAYb,WAAW;YAYX,YAAY;YAOZ,SAAS;YAOT,QAAQ;YAOR,OAAO;IA8BrB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,aAAa;IAuNrB,OAAO,CAAC,aAAa;IAgJrB,OAAO,CAAC,aAAa;IAoKrB,OAAO,CAAC,aAAa;IA8IrB,OAAO,CAAC,aAAa;IAiFrB,OAAO,CAAC,aAAa;IA8HrB,OAAO,CAAC,aAAa;CAoFtB"}