@aarav-j/zephyr-mcp-server 0.1.0

package/dist/index.js

@@ -0,0 +1,451 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema, ErrorCode, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { ZephyrDatabase, getCacheDir } from "./db.js";
+import { existsSync, readdirSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+// --- Database loading ---
+let db = null;
+let currentVersion = null;
+function loadLatestIndex() {
+    const cacheDir = getCacheDir();
+    if (!existsSync(cacheDir))
+        return;
+    const entries = readdirSync(cacheDir, { withFileTypes: true });
+    const versionDirs = entries
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .sort()
+        .reverse();
+    for (const ver of versionDirs) {
+        const dbPath = join(cacheDir, ver, "zephyr-index.db");
+        if (existsSync(dbPath)) {
+            try {
+                const candidate = new ZephyrDatabase(dbPath);
+                const stored = candidate.getMeta("version");
+                if (stored) {
+                    db = candidate;
+                    currentVersion = stored;
+                    console.error(`Loaded index: ${stored} from ${dbPath}`);
+                    return;
+                }
+                candidate.close();
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+}
+// --- Server setup ---
+const server = new Server({ name: "@aarav-j/zephyr-mcp-server", version: "0.1.0" }, { capabilities: { tools: {} } });
+// --- Tool definitions ---
+const GET_FUNCTION_SIGNATURE_TOOL = {
+    name: "get_function_signature",
+    description: "Look up the exact C function or macro signature, parameters, return type, and header location from Zephyr's Doxygen API docs.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Function or macro name (e.g. k_sem_take, GPIO_DT_SPEC_GET)",
+            },
+            version: {
+                type: "string",
+                description: "Zephyr version tag (e.g. v4.1.0). Defaults to latest cached.",
+            },
+        },
+        required: ["name"],
+    },
+};
+const FIND_KCONFIG_TOOL = {
+    name: "find_kconfig",
+    description: "Search Zephyr Kconfig symbols by name or description. Returns matching symbols with their type, prompt, default value, and dependency chain.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            pattern: {
+                type: "string",
+                description: "Search pattern (e.g. GPIO, CONFIG_I2C, USB)",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum results. Default 10, max 50.",
+                default: 10,
+            },
+            version: {
+                type: "string",
+                description: "Zephyr version tag. Defaults to latest cached.",
+            },
+        },
+        required: ["pattern"],
+    },
+};
+const GET_DT_BINDING_TOOL = {
+    name: "get_dt_binding",
+    description: "Look up a Devicetree binding by compatible string. Returns the binding schema including required and optional properties, bus information, and child bindings.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            compatible: {
+                type: "string",
+                description: "Devicetree compatible string (e.g. st,stm32-i2c, arm,cortex-m4)",
+            },
+            version: {
+                type: "string",
+                description: "Zephyr version tag. Defaults to latest cached.",
+            },
+        },
+        required: ["compatible"],
+    },
+};
+const SEARCH_DOCS_TOOL = {
+    name: "search_docs",
+    description: "Full-text search across Zephyr documentation, API reference, Kconfig help text, and DT binding descriptions.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Search query (e.g. 'semaphore timeout', 'gpio interrupt', 'i2c stm32')",
+            },
+            domain: {
+                type: "string",
+                description: "Scope: 'api', 'kconfig', 'dt', or omit for all",
+                enum: ["api", "kconfig", "dt"],
+            },
+            limit: {
+                type: "number",
+                description: "Maximum results. Default 10, max 30.",
+                default: 10,
+            },
+            version: {
+                type: "string",
+                description: "Zephyr version tag. Defaults to latest cached.",
+            },
+        },
+        required: ["query"],
+    },
+};
+// --- Request handlers ---
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        GET_FUNCTION_SIGNATURE_TOOL,
+        FIND_KCONFIG_TOOL,
+        GET_DT_BINDING_TOOL,
+        SEARCH_DOCS_TOOL,
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const tool = request.params.name;
+    const args = request.params.arguments ?? {};
+    if (!db) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "No index loaded.",
+                        hint: "Run `npx tsx scripts/build-index.ts --source /path/to/zephyr` to build the index first.",
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    switch (tool) {
+        // --- get_function_signature ---
+        case "get_function_signature": {
+            const name = String(args.name ?? "");
+            if (!name) {
+                throw new McpError(ErrorCode.InvalidParams, "Missing required argument: name");
+            }
+            const fn = db.getFunctionByName(name);
+            if (!fn) {
+                const results = db.searchFunctions(name, 5);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                name,
+                                found: false,
+                                suggestions: results
+                                    .filter((r) => r.name.toLowerCase() !== name.toLowerCase())
+                                    .map((r) => ({
+                                    name: r.name,
+                                    signature: r.signature,
+                                    header: r.header,
+                                })),
+                                version: currentVersion,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            name: fn.name,
+                            signature: fn.signature,
+                            brief: fn.brief,
+                            params: fn.params ? JSON.parse(fn.params) : [],
+                            return_type: fn.return_type,
+                            return_desc: fn.return_desc,
+                            header: fn.header,
+                            section: fn.section,
+                            version: currentVersion,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        // --- find_kconfig ---
+        case "find_kconfig": {
+            const pattern = String(args.pattern ?? "");
+            if (!pattern) {
+                throw new McpError(ErrorCode.InvalidParams, "Missing required argument: pattern");
+            }
+            const limit = Math.min(Math.max(Number(args.limit ?? 10), 1), 50);
+            const results = db.searchKconfig(pattern, limit);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            pattern,
+                            found: results.length > 0,
+                            count: results.length,
+                            results: results.map((r) => ({
+                                name: r.name,
+                                type: r.type,
+                                prompt: r.prompt,
+                                default: r.default_val,
+                                depends_on: r.depends_on ? JSON.parse(r.depends_on) : [],
+                                path: r.path,
+                            })),
+                            version: currentVersion,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        // --- get_dt_binding ---
+        case "get_dt_binding": {
+            const compatible = String(args.compatible ?? "");
+            if (!compatible) {
+                throw new McpError(ErrorCode.InvalidParams, "Missing required argument: compatible");
+            }
+            // Try exact match first (avoids FTS5 comma syntax issues)
+            let binding = db.getBindingByCompatible(compatible);
+            if (!binding) {
+                // Fall back to FTS search
+                const results = db.searchBindings(compatible, 5);
+                binding = results.find((r) => r.compatible === compatible) ?? results[0] ?? null;
+            }
+            if (!binding) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                compatible,
+                                found: false,
+                                suggestions: [],
+                                version: currentVersion,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            compatible: binding.compatible,
+                            description: binding.description,
+                            properties: binding.properties ? JSON.parse(binding.properties) : null,
+                            child_binding: binding.child_binding ? JSON.parse(binding.child_binding) : null,
+                            bus: binding.bus,
+                            on_bus: binding.on_bus,
+                            path: binding.path,
+                            version: currentVersion,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        // --- search_docs ---
+        case "search_docs": {
+            const query = String(args.query ?? "");
+            if (!query) {
+                throw new McpError(ErrorCode.InvalidParams, "Missing required argument: query");
+            }
+            const domain = String(args.domain ?? "");
+            const limit = Math.min(Math.max(Number(args.limit ?? 10), 1), 30);
+            const allResults = [];
+            if (!domain || domain === "api") {
+                const fnResults = db.searchFunctions(query, limit);
+                for (const r of fnResults) {
+                    allResults.push({
+                        domain: "api",
+                        title: r.name,
+                        snippet: r.signature,
+                        path: r.header ?? undefined,
+                    });
+                }
+            }
+            if (!domain || domain === "kconfig") {
+                const kcResults = db.searchKconfig(query, limit);
+                for (const r of kcResults) {
+                    allResults.push({
+                        domain: "kconfig",
+                        title: r.name,
+                        snippet: r.prompt ?? r.help_text ?? "",
+                        path: r.path ?? undefined,
+                    });
+                }
+            }
+            if (!domain || domain === "dt") {
+                const dtResults = db.searchBindings(query, limit);
+                for (const r of dtResults) {
+                    allResults.push({
+                        domain: "dt",
+                        title: r.compatible,
+                        snippet: r.description ?? "",
+                        path: r.path ?? undefined,
+                    });
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            query,
+                            count: allResults.length,
+                            results: allResults.slice(0, limit),
+                            version: currentVersion,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        default:
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${tool}`);
+    }
+});
+// --- Start ---
+// --- Version check ---
+const GITHUB_API = "https://api.github.com/repos/zephyrproject-rtos/zephyr/releases/latest";
+async function checkLatestVersion() {
+    try {
+        const resp = await fetch(GITHUB_API, {
+            headers: { "Accept": "application/vnd.github.v3+json" },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!resp.ok)
+            return null;
+        const data = (await resp.json());
+        return data.tag_name;
+    }
+    catch {
+        return null;
+    }
+}
+// --- Start ---
+async function downloadPrebuiltIndex() {
+    const REPO = "Aarav-J/zephyr-mcp-server";
+    const RELEASES_API = `https://api.github.com/repos/${REPO}/releases/latest`;
+    try {
+        console.error("[download] Checking for pre-built index...");
+        const resp = await fetch(RELEASES_API, {
+            headers: { "Accept": "application/vnd.github.v3+json" },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!resp.ok) {
+            console.error(`[download] Failed to fetch release info: ${resp.status}`);
+            return null;
+        }
+        const data = (await resp.json());
+        // Find the index asset
+        const asset = data.assets.find((a) => a.name.endsWith(".db"));
+        if (!asset) {
+            console.error("[download] No index asset found in latest release");
+            return null;
+        }
+        console.error(`[download] Downloading ${asset.name}...`);
+        const dbResp = await fetch(asset.browser_download_url, {
+            signal: AbortSignal.timeout(60_000),
+        });
+        if (!dbResp.ok) {
+            console.error(`[download] Download failed: ${dbResp.status}`);
+            return null;
+        }
+        const buffer = await dbResp.arrayBuffer();
+        const cacheDir = getCacheDir();
+        const versionDir = join(cacheDir, data.tag_name);
+        mkdirSync(versionDir, { recursive: true });
+        const dbPath = join(versionDir, "zephyr-index.db");
+        writeFileSync(dbPath, Buffer.from(buffer));
+        console.error(`[download] Saved index to ${dbPath}`);
+        const loaded = new ZephyrDatabase(dbPath);
+        const stored = loaded.getMeta("version");
+        if (stored) {
+            db = loaded;
+            currentVersion = stored;
+            console.error(`[download] Loaded index: ${stored}`);
+            return loaded;
+        }
+        loaded.close();
+        return null;
+    }
+    catch (err) {
+        console.error(`[download] Error: ${err}`);
+        return null;
+    }
+}
+// --- Start ---
+async function main() {
+    // Try local cache first
+    loadLatestIndex();
+    // If no local index, download pre-built one
+    if (!db) {
+        console.error("No local index found. Attempting to download pre-built index...");
+        await downloadPrebuiltIndex();
+    }
+    // Fire-and-forget version check
+    checkLatestVersion().then((latest) => {
+        if (latest && currentVersion && latest !== currentVersion) {
+            console.error(`[update] New Zephyr release: ${latest} (cached: ${currentVersion})`);
+            console.error(`[update] Run: cd zephyr-mcp-server && npm run build-index ${latest}`);
+        }
+        else if (latest && !currentVersion) {
+            console.error(`[update] Latest Zephyr release: ${latest}`);
+            console.error(`[update] Run: cd zephyr-mcp-server && npm run build-index ${latest}`);
+        }
+        else if (latest && latest === currentVersion) {
+            console.error(`[update] Index is up-to-date (${latest})`);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Zephyr MCP server started on stdio");
+    if (db) {
+        console.error(`Active index: ${currentVersion}`);
+    }
+    else {
+        console.error("No index loaded.");
+        console.error("  If first run, the server should auto-download a pre-built index.");
+        console.error("  Otherwise, run: git clone https://github.com/Aarav-J/zephyr-mcp-server.git");
+        console.error("  Then: cd zephyr-mcp-server && npm install && npm run build");
+    }
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/parsers/doxygen.d.ts

@@ -0,0 +1,14 @@
+import { FunctionRow } from "../db.js";
+export interface ParseResult {
+    functions: FunctionRow[];
+    sourcePath: string;
+}
+/**
+ * Parse a single Doxygen XML file and return extracted functions.
+ */
+export declare function parseDoxygenFile(filePath: string): ParseResult;
+/**
+ * Parse all Doxygen XML files in a directory, extracting functions.
+ */
+export declare function parseDoxygenDirectory(dirPath: string): ParseResult;
+//# sourceMappingURL=doxygen.d.ts.map

package/dist/parsers/doxygen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doxygen.d.ts","sourceRoot":"","sources":["../../src/parsers/doxygen.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAqNvC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAY9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAwBlE"}

package/dist/parsers/doxygen.js

@@ -0,0 +1,184 @@
+import { XMLParser } from "fast-xml-parser";
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+// --- XML parsing ---
+const parser = new XMLParser({
+    ignoreAttributes: false,
+    attributeNamePrefix: "@_",
+    isArray: (name) => ["compounddef", "sectiondef", "memberdef", "param", "para", "listitem"].includes(name),
+    processEntities: true,
+    htmlEntities: true,
+});
+// --- Text extraction ---
+/** Extract plain text from a Doxygen para element (may contain nested formatting). */
+function extractParaText(para) {
+    if (para === null || para === undefined)
+        return "";
+    if (typeof para === "string")
+        return para;
+    if (typeof para === "number")
+        return String(para);
+    if (Array.isArray(para)) {
+        return para.map(extractParaText).join(" ").trim();
+    }
+    if (typeof para !== "object")
+        return "";
+    // Direct text content
+    if ("#text" in para && typeof para["#text"] === "string") {
+        return para["#text"];
+    }
+    const obj = para;
+    // Nested paragraph
+    if (obj.para)
+        return extractParaText(obj.para);
+    // ulink element
+    if (obj.ulink && typeof obj.ulink === "object") {
+        const ulink = obj.ulink;
+        const url = typeof ulink["@_url"] === "string" ? ulink["@_url"] : "";
+        const text = extractParaText(ulink.para ?? obj.ulink);
+        return text || url;
+    }
+    // Formatted inline elements
+    for (const key of ["bold", "emphasis", "computeroutput"]) {
+        if (obj[key])
+            return extractParaText(obj[key]);
+    }
+    // ref element
+    if (obj.ref && typeof obj.ref === "object") {
+        const ref = obj.ref;
+        const text = typeof ref["#text"] === "string" ? ref["#text"] : "";
+        return text || extractParaText(ref);
+    }
+    return "";
+}
+/** Extract text from a brief/detailed description block. */
+function extractDescription(desc) {
+    if (!desc)
+        return "";
+    if (typeof desc !== "object")
+        return "";
+    const d = desc;
+    return extractParaText(d.para ?? d);
+}
+/** Build full function signature from type + name + args. */
+function buildSignature(member) {
+    let returnType = "";
+    if (member.type) {
+        if (typeof member.type === "string") {
+            returnType = member.type;
+        }
+        else if ("#text" in member.type) {
+            returnType = member.type["#text"] ?? "";
+        }
+    }
+    const name = member.name ?? "";
+    const args = member.argsstring ?? "()";
+    if (args.startsWith("(")) {
+        return `${returnType} ${name}${args}`;
+    }
+    if (args.startsWith(returnType) || returnType === "") {
+        return args;
+    }
+    return `${returnType} ${name}${args.startsWith("(") ? args : `(${args})`}`;
+}
+/** Extract name from a param element. */
+function extractParamName(param) {
+    return param.declname ?? "";
+}
+/** Extract type string from a Doxygen type element. */
+function extractTypeString(typeVal) {
+    if (!typeVal)
+        return "";
+    if (typeof typeVal === "string")
+        return typeVal;
+    if (typeof typeVal === "object" && "#text" in typeVal) {
+        const v = typeVal["#text"];
+        return typeof v === "string" ? v : "";
+    }
+    return "";
+}
+// --- Parsing engine ---
+/** Parse a single Doxygen compounddef and extract all functions. */
+function parseCompounddef(compound, _sourcePath) {
+    const rows = [];
+    const groupId = compound.compoundname ?? null;
+    const section = compound.title ?? null;
+    const candidates = [];
+    if (compound.sectiondef) {
+        for (const sectiondef of compound.sectiondef) {
+            if (sectiondef["@_kind"] === "func" && sectiondef.memberdef) {
+                candidates.push(...sectiondef.memberdef);
+            }
+        }
+    }
+    if (compound.memberdef) {
+        candidates.push(...compound.memberdef);
+    }
+    for (const member of candidates) {
+        if (member["@_kind"] !== "function")
+            continue;
+        if (!member.name)
+            continue;
+        const params = (member.param ?? []).map((p) => ({
+            name: extractParamName(p),
+            type: extractTypeString(p.type),
+            description: extractDescription(p.briefdescription),
+        }));
+        const row = {
+            name: member.name,
+            signature: buildSignature(member),
+            brief: extractDescription(member.briefdescription) || null,
+            description: extractDescription(member.detaileddescription) || null,
+            params: params.length > 0 ? JSON.stringify(params) : null,
+            return_type: extractTypeString(member.type) || null,
+            return_desc: null,
+            header: member.location?.["@_declfile"] ?? member.location?.["@_file"] ?? null,
+            section: section ?? null,
+            group_id: groupId,
+        };
+        rows.push(row);
+    }
+    return rows;
+}
+/**
+ * Parse a single Doxygen XML file and return extracted functions.
+ */
+export function parseDoxygenFile(filePath) {
+    const xml = readFileSync(filePath, "utf-8");
+    const parsed = parser.parse(xml);
+    const compounds = parsed.doxygen?.compounddef ?? [];
+    const functions = [];
+    for (const compound of compounds) {
+        const rows = parseCompounddef(compound, filePath);
+        functions.push(...rows);
+    }
+    return { functions, sourcePath: filePath };
+}
+/**
+ * Parse all Doxygen XML files in a directory, extracting functions.
+ */
+export function parseDoxygenDirectory(dirPath) {
+    const allFunctions = [];
+    if (!existsSync(dirPath)) {
+        throw new Error(`Doxygen XML directory not found: ${dirPath}`);
+    }
+    const entries = readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        if (!entry.name.endsWith(".xml"))
+            continue;
+        if (entry.name === "index.xml")
+            continue;
+        const filePath = join(dirPath, entry.name);
+        try {
+            const result = parseDoxygenFile(filePath);
+            allFunctions.push(...result.functions);
+        }
+        catch {
+            continue;
+        }
+    }
+    return { functions: allFunctions, sourcePath: dirPath };
+}
+//# sourceMappingURL=doxygen.js.map