driverge-mcp 0.0.0

package/dist/server.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+// Driverge MCP server — entry point.
+//
+// Exposes a stdio MCP server built with @modelcontextprotocol/sdk. Alongside a
+// `ping` health check it registers the full Driverge surface (Session 6):
+// analyze_datasheet / generate_driver / validate_driver / validate_datasheet
+// tools, the datasheet + schema resources, and the generate-driver prompt.
+// See wiki: mcp-tool-usage-flow.
+import { fileURLToPath } from "node:url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { registerDriverge } from "./mcp/register.js";
+const SERVER_NAME = "driverge-mcp";
+const SERVER_VERSION = "0.0.0";
+/**
+ * Build a Driverge MCP server with its tools registered. Kept separate from the
+ * transport wiring so tests can drive it over an in-memory transport.
+ */
+export function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    server.registerTool("ping", {
+        title: "Ping",
+        description: "Health check — returns 'pong' to confirm the Driverge MCP server is running.",
+        inputSchema: { message: z.string().optional() },
+    }, async ({ message }) => ({
+        content: [
+            { type: "text", text: message ? `pong: ${message}` : "pong" },
+        ],
+    }));
+    registerDriverge(server);
+    return server;
+}
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Start the stdio server only when this file is executed directly (via the
+// `driverge` bin), not when imported — e.g. by the test suite.
+const isDirectRun = process.argv[1] !== undefined &&
+    fileURLToPath(import.meta.url) === process.argv[1];
+if (isDirectRun) {
+    main().catch((error) => {
+        console.error("driverge-mcp failed to start:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,qCAAqC;AACrC,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,iCAAiC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,GAAG,cAAc,CAAC;AACnC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAE7E,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EACT,8EAA8E;QAChF,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;KAChD,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;SACvE;KACF,CAAC,CACH,CAAC;IAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAErD,IAAI,WAAW,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "driverge-mcp",
+  "version": "0.0.0",
+  "description": "MCP server that turns IC datasheet PDFs into embedded C/C++ drivers, driven by any MCP client.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "embedded",
+    "datasheet",
+    "driver",
+    "codegen",
+    "stm32",
+    "esp32"
+  ],
+  "license": "MIT",
+  "author": "Mehmet Topuz",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MehmetTopuz/driverge-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MehmetTopuz/driverge-mcp/issues"
+  },
+  "homepage": "https://github.com/MehmetTopuz/driverge-mcp#readme",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "driverge": "dist/server.js"
+  },
+  "main": "dist/server.js",
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/node": "^26.1.0",
+    "eslint": "^9.39.4",
+    "pdf-lib": "^1.17.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.62.1",
+    "vitest": "^4.1.9"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "pdfjs-dist": "^6.1.200",
+    "zod": "^4.4.3"
+  }
+}

package/schemas/datasheet.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://driverge.dev/schemas/datasheet.schema.json",
+  "title": "Driverge Datasheet",
+  "description": "The parsed, validated datasheet handed (by ref) to the host AI. The `interface` field is a discriminated union on `kind`.",
+  "type": "object",
+  "required": ["metadata", "protocol", "interface", "validation"],
+  "additionalProperties": false,
+  "properties": {
+    "metadata": {
+      "type": "object",
+      "required": ["part", "manufacturer", "manufacturerConfidence", "pdfType", "pageCount"],
+      "additionalProperties": false,
+      "properties": {
+        "part": { "type": "string" },
+        "manufacturer": { "type": "string" },
+        "manufacturerConfidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "pdfType": { "enum": ["text_based", "scanned", "mixed"] },
+        "pageCount": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "protocol": {
+      "type": "object",
+      "required": ["bus"],
+      "additionalProperties": false,
+      "properties": {
+        "bus": { "enum": ["I2C", "SPI", "UART", "unknown"] },
+        "addresses": { "type": "array", "items": { "type": "string" } },
+        "maxClockHz": { "type": "number", "minimum": 0 }
+      }
+    },
+    "interface": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["kind", "registers"],
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "const": "register_map" },
+            "registers": { "type": "array", "items": { "$ref": "#/definitions/register" } }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["kind", "commands"],
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "const": "command_set" },
+            "commands": { "type": "array", "items": { "$ref": "#/definitions/command" } }
+          }
+        }
+      ]
+    },
+    "validation": {
+      "type": "object",
+      "required": ["valid", "errors", "warnings"],
+      "additionalProperties": false,
+      "properties": {
+        "valid": { "type": "boolean" },
+        "errors": { "type": "array", "items": { "type": "string" } },
+        "warnings": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  },
+  "definitions": {
+    "register": {
+      "type": "object",
+      "required": ["name", "address", "reset", "bitFields"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "address": { "type": "string" },
+        "reset": { "type": "string" },
+        "bitFields": { "type": "array", "items": { "$ref": "#/definitions/bitField" } }
+      }
+    },
+    "bitField": {
+      "type": "object",
+      "required": ["name", "msb", "lsb"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "msb": { "type": "integer", "minimum": 0, "maximum": 7 },
+        "lsb": { "type": "integer", "minimum": 0, "maximum": 7 }
+      }
+    },
+    "command": {
+      "type": "object",
+      "required": ["name", "code"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string" },
+        "code": { "type": "string", "pattern": "^0x[0-9A-Fa-f]+$" },
+        "params": { "type": "array", "items": { "type": "string" } },
+        "responseWords": { "type": "integer", "minimum": 0 },
+        "crc": {
+          "type": "object",
+          "required": ["poly", "init", "width"],
+          "additionalProperties": false,
+          "properties": {
+            "poly": { "type": "string" },
+            "init": { "type": "string" },
+            "width": { "type": "integer", "minimum": 1 }
+          }
+        }
+      }
+    }
+  }
+}