@dawmatt/api-grade-mcp 0.1.0

package/dist/utils/errors.d.ts

@@ -0,0 +1,33 @@
+export declare const ERROR_CODES: {
+    readonly SPEC_NOT_FOUND: "SPEC_NOT_FOUND";
+    readonly SPEC_PARSE_ERROR: "SPEC_PARSE_ERROR";
+    readonly RULESET_NOT_FOUND: "RULESET_NOT_FOUND";
+    readonly INVALID_GRADE: "INVALID_GRADE";
+    readonly GRADE_ENGINE_ERROR: "GRADE_ENGINE_ERROR";
+    readonly RULESET_AUTH_FAILED: "RULESET_AUTH_FAILED";
+    readonly ENTRA_AUTH_REQUIRED: "ENTRA_AUTH_REQUIRED";
+    readonly INVALID_AUTH_CONFIG: "INVALID_AUTH_CONFIG";
+    readonly CONFIG_WRITE_ERROR: "CONFIG_WRITE_ERROR";
+    readonly REQUEST_CANCELLED: "REQUEST_CANCELLED";
+};
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+export interface McpErrorResponse {
+    error: ErrorCode;
+    message: string;
+    input: Record<string, unknown>;
+}
+export declare function mcpError(code: ErrorCode, message: string, input: Record<string, unknown>): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    isError: true;
+};
+export declare function buildAuthFailureResponse(failureReason: string, rulesetUrl: string, scope: string, message: string): {
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+    isError: true;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;;;;CAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAM9D;AAyBD,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAa9D"}

package/dist/utils/errors.js

@@ -0,0 +1,56 @@
+export const ERROR_CODES = {
+    SPEC_NOT_FOUND: 'SPEC_NOT_FOUND',
+    SPEC_PARSE_ERROR: 'SPEC_PARSE_ERROR',
+    RULESET_NOT_FOUND: 'RULESET_NOT_FOUND',
+    INVALID_GRADE: 'INVALID_GRADE',
+    GRADE_ENGINE_ERROR: 'GRADE_ENGINE_ERROR',
+    RULESET_AUTH_FAILED: 'RULESET_AUTH_FAILED',
+    ENTRA_AUTH_REQUIRED: 'ENTRA_AUTH_REQUIRED',
+    INVALID_AUTH_CONFIG: 'INVALID_AUTH_CONFIG',
+    CONFIG_WRITE_ERROR: 'CONFIG_WRITE_ERROR',
+    REQUEST_CANCELLED: 'REQUEST_CANCELLED',
+};
+export function mcpError(code, message, input) {
+    const body = { error: code, message, input };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body) }],
+        isError: true,
+    };
+}
+const RECOVERY_OPTIONS = [
+    {
+        id: 'retry',
+        label: 'Retry',
+        description: 'Attempt to fetch the ruleset again (re-run this grading request using the configured default).',
+    },
+    {
+        id: 'use-builtin-once',
+        label: 'Use built-in default for this request',
+        description: 'Grade using the built-in api-grade ruleset for this one request only. The configured default remains active for future requests.',
+    },
+    {
+        id: 'use-builtin-session',
+        label: 'Use built-in default for this session',
+        description: 'Grade using the built-in api-grade ruleset for all remaining requests this session. The configured default is not changed.',
+    },
+    {
+        id: 'cancel',
+        label: 'Cancel',
+        description: 'Cancel this grading request without returning a result.',
+    },
+];
+export function buildAuthFailureResponse(failureReason, rulesetUrl, scope, message) {
+    const body = {
+        error: ERROR_CODES.RULESET_AUTH_FAILED,
+        failureReason,
+        rulesetUrl,
+        scope,
+        message,
+        recoveryOptions: RECOVERY_OPTIONS,
+    };
+    return {
+        content: [{ type: 'text', text: JSON.stringify(body) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC;AAUX,MAAM,UAAU,QAAQ,CACtB,IAAe,EACf,OAAe,EACf,KAA8B;IAE9B,MAAM,IAAI,GAAqB,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC/D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,gBAAgB,GAAG;IACvB;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,gGAAgG;KAC9G;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE,kIAAkI;KAChJ;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EAAE,4HAA4H;KAC1I;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,yDAAyD;KACvE;CACO,CAAC;AAEX,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,UAAkB,EAClB,KAAa,EACb,OAAe;IAEf,MAAM,IAAI,GAAG;QACX,KAAK,EAAE,WAAW,CAAC,mBAAmB;QACtC,aAAa;QACb,UAAU;QACV,KAAK;QACL,OAAO;QACP,eAAe,EAAE,gBAAgB;KAClC,CAAC;IACF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@dawmatt/api-grade-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing api-grade capabilities for LLMs and agentic AI tooling",
+  "keywords": [
+    "api",
+    "openapi",
+    "asyncapi",
+    "spectral",
+    "quality",
+    "grading",
+    "mcp",
+    "model-context-protocol",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DawMatt/api-grade.git"
+  },
+  "homepage": "https://github.com/DawMatt/api-grade/tree/main/packages/api-grade-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/DawMatt/api-grade/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "api-grade-mcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@azure/msal-node": "^2.16.2",
+    "@dawmatt/api-grade-core": "*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist"
+  ]
+}