@aarav-j/zephyr-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,199 @@
+# Zephyr RTOS MCP Server
+
+An MCP (Model Context Protocol) server that gives LLMs grounded access to Zephyr RTOS documentation — Kconfig symbols, Devicetree bindings, and API signatures. No more hallucinated driver structs or made-up Kconfig options.
+
+## Quick Start
+
+```bash
+git clone https://github.com/Aarav-J/zephyr-mcp-server.git
+cd zephyr-mcp-server
+npm install
+npm run build
+```
+
+Add to your MCP client config (e.g. `~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "zephyr": {
+      "command": "node",
+      "args": ["/absolute/path/to/zephyr-mcp-server/dist/index.js"]
+    }
+  }
+}
+```
+
+First startup auto-downloads a pre-built index (8.5 MB) with data from the latest Zephyr release. No manual setup needed.
+
+## Tools
+
+### `get_function_signature`
+
+Look up exact C function or macro signatures, parameters, return types, and header locations.
+
+```
+Arguments:
+  name      — Function or macro name (e.g. k_sem_take, GPIO_DT_SPEC_GET)
+  version?  — Zephyr version tag. Defaults to latest cached.
+
+Returns:
+  - signature    — Exact C signature with types
+  - brief        — One-line description
+  - params       — Typed parameter list with descriptions
+  - return_type  — Return type
+  - return_desc  — Return value description
+  - header       — Declaring header file
+  - section      — Doxygen group/section
+```
+
+> Requires Doxygen XML output to be indexed (see Building a Full Index).
+
+### `find_kconfig`
+
+Search Zephyr Kconfig symbols by name or description.
+
+```
+Arguments:
+  pattern   — Search string (e.g. GPIO, CONFIG_I2C, USB)
+  limit?    — Max results. Default 10, max 50.
+  version?  — Zephyr version tag.
+
+Returns:
+  - name         — Symbol name (CONFIG_*)
+  - type         — bool, string, int, hex, tristate
+  - prompt       — User-visible prompt text
+  - default      — Default value
+  - depends_on   — Dependency symbol chain
+  - path         — File path in Zephyr tree
+```
+
+### `get_dt_binding`
+
+Look up a Devicetree binding by compatible string.
+
+```
+Arguments:
+  compatible — Compatible string (e.g. st,stm32-i2c, arm,cortex-m4)
+  version?   — Zephyr version tag.
+
+Returns:
+  - compatible    — Compatible string
+  - description   — Binding description
+  - properties    — Schema with types, required/optional status, defaults
+  - child_binding — Child binding schema (if any)
+  - bus           — Bus type this binding provides
+  - on_bus        — Bus this binding lives on
+  - path          — YAML file path in Zephyr tree
+```
+
+### `search_docs`
+
+Full-text search across indexed documentation domains.
+
+```
+Arguments:
+  query     — Search query (e.g. "semaphore", "i2c stm32", "gpio interrupt")
+  domain?   — Scope: "api", "kconfig", "dt", or omit for all
+  limit?    — Max results. Default 10, max 30.
+  version?  — Zephyr version tag.
+
+Returns:
+  - query    — Original query
+  - count    — Total results found
+  - results  — Ranked list of { domain, title, snippet, path }
+```
+
+## Index
+
+### Pre-built Index (auto-downloaded)
+
+The server automatically downloads a pre-built index from GitHub Releases on first startup. The current index covers:
+
+| Data | Count |
+|---|---|
+| Kconfig symbols | 24,118 |
+| Devicetree bindings | 3,553 |
+| Index size | 8.5 MB |
+
+This is enough for the `find_kconfig`, `get_dt_binding`, and `search_docs` tools to work immediately.
+
+### Building a Full Index (with API signatures)
+
+To also index function signatures, you need Doxygen XML output from Zephyr's documentation build:
+
+```bash
+# Option 1: Build Zephyr docs yourself
+# (requires a full Zephyr build environment)
+cd /path/to/zephyr
+west build -t doxygen
+# Doxygen XML will be in build/zephyr-doc/xml/
+
+# Option 2: Use the pre-built docs source
+npx tsx scripts/build-index.ts v4.4.1 \
+  --source /path/to/zephyr \
+  --doxygen /path/to/zephyr/build/zephyr-doc/xml/
+```
+
+### Building from Source
+
+If you want to build the index from a specific Zephyr release:
+
+```bash
+# Download and index Kconfig + DT bindings from Zephyr source
+npx tsx scripts/build-index.ts v4.4.1 --source /path/to/zephyr
+```
+
+The CLI accepts a local Zephyr source directory. On first run against a new version, it will download the Zephyr source tarball automatically.
+
+## Version Management
+
+The server checks for new Zephyr releases on startup and logs a message when one is available:
+
+```
+[update] New Zephyr release: v4.5.0 (cached: v4.4.1)
+[update] Run: cd zephyr-mcp-server && npm run build-index v4.5.0
+```
+
+## Architecture
+
+```
+zephyr-mcp-server/
+├── src/
+│   ├── index.ts                 # MCP server + tool handlers
+│   ├── db.ts                    # SQLite FTS5 database layer
+│   └── parsers/
+│       ├── doxygen.ts           # Doxygen XML → FunctionRow[]
+│       ├── kconfig.ts           # Kconfig → KconfigRow[]
+│       └── dt-bindings.ts       # YAML bindings → DtBindingRow[]
+├── scripts/
+│   └── build-index.ts           # Index builder CLI
+├── dist/                        # Compiled output
+└── test/
+    └── fixtures/                # Test fixtures
+```
+
+## Development
+
+```bash
+npm run build      # Compile TypeScript
+npm run start      # Start MCP server on stdio
+npm run build-index <version> --source <path>   # Build index
+```
+
+## Contributing
+
+PRs welcome. Key areas for improvement:
+
+- **Doxygen XML fetching** — Automate downloading or building Doxygen XML for pre-built index releases
+- **Kconfig parser quality** — Current parser is regex-based; switching to kconfiglib (Python) would improve accuracy
+- **RST docs chunking** — Parse Zephyr's RST documentation for richer prose search results
+- **CI pipeline** — GitHub Action to auto-build indexes on new Zephyr releases
+
+## License
+
+MIT
+
+---
+
+Built for [Oh My Pi](https://github.com/Aarav-J/personal_hermes) club.

package/dist/db.d.ts

@@ -0,0 +1,72 @@
+export interface FunctionRow {
+    id?: number;
+    name: string;
+    signature: string;
+    brief: string | null;
+    description: string | null;
+    params: string | null;
+    return_type: string | null;
+    return_desc: string | null;
+    header: string | null;
+    section: string | null;
+    group_id: string | null;
+}
+export interface KconfigRow {
+    id?: number;
+    name: string;
+    type: string | null;
+    prompt: string | null;
+    default_val: string | null;
+    depends_on: string | null;
+    select_list: string | null;
+    range_min: string | null;
+    range_max: string | null;
+    help_text: string | null;
+    path: string | null;
+}
+export interface DtBindingRow {
+    id?: number;
+    compatible: string;
+    description: string | null;
+    properties: string | null;
+    child_binding: string | null;
+    bus: string | null;
+    on_bus: string | null;
+    path: string | null;
+}
+export interface DocChunkRow {
+    id?: number;
+    title: string | null;
+    heading_path: string | null;
+    body: string | null;
+    source_url: string | null;
+    domain: string | null;
+}
+export declare function getCacheDir(): string;
+export declare class ZephyrDatabase {
+    private db;
+    constructor(dbPath: string);
+    /** Create or migrate schema. Idempotent. */
+    initialize(): void;
+    insertFunction(row: FunctionRow): void;
+    insertFunctionsBatch(rows: FunctionRow[]): void;
+    insertKconfig(row: KconfigRow): void;
+    insertKconfigsBatch(rows: KconfigRow[]): void;
+    insertDtBinding(row: DtBindingRow): void;
+    insertDtBindingsBatch(rows: DtBindingRow[]): void;
+    insertDocChunk(row: DocChunkRow): void;
+    insertDocChunksBatch(rows: DocChunkRow[]): void;
+    rebuildFts(): void;
+    setMeta(key: string, value: string): void;
+    getMeta(key: string): string | undefined;
+    /** Add FTS5 prefix wildcard to last token, and escape special characters. */
+    private ftsQuery;
+    getFunctionByName(name: string): FunctionRow | undefined;
+    getBindingByCompatible(compatible: string): DtBindingRow | undefined;
+    searchFunctions(query: string, limit?: number): FunctionRow[];
+    searchKconfig(query: string, limit?: number): KconfigRow[];
+    searchBindings(query: string, limit?: number): DtBindingRow[];
+    searchDocs(query: string, limit?: number): DocChunkRow[];
+    close(): void;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

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

package/dist/db.js

@@ -0,0 +1,343 @@
+import Database from "better-sqlite3";
+import { mkdirSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// --- Database Manager ---
+export function getCacheDir() {
+    const dir = join(homedir(), ".zephyr-mcp", "indexes");
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+export class ZephyrDatabase {
+    db;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("foreign_keys = ON");
+    }
+    /** Create or migrate schema. Idempotent. */
+    initialize() {
+        this.db.exec(`
+      -- Functions table
+      CREATE TABLE IF NOT EXISTS functions (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL,
+        signature TEXT NOT NULL,
+        brief TEXT,
+        description TEXT,
+        params TEXT,
+        return_type TEXT,
+        return_desc TEXT,
+        header TEXT,
+        section TEXT,
+        group_id TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_functions_name ON functions(name);
+
+      -- Kconfig symbols table
+      CREATE TABLE IF NOT EXISTS kconfig_symbols (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL,
+        type TEXT,
+        prompt TEXT,
+        default_val TEXT,
+        depends_on TEXT,
+        select_list TEXT,
+        range_min TEXT,
+        range_max TEXT,
+        help_text TEXT,
+        path TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_kconfig_name ON kconfig_symbols(name);
+
+      -- Devicetree bindings table
+      CREATE TABLE IF NOT EXISTS dt_bindings (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        compatible TEXT NOT NULL,
+        description TEXT,
+        properties TEXT,
+        child_binding TEXT,
+        bus TEXT,
+        on_bus TEXT,
+        path TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_dt_compatible ON dt_bindings(compatible);
+
+      -- Docs chunks table
+      CREATE TABLE IF NOT EXISTS docs_chunks (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        title TEXT,
+        heading_path TEXT,
+        body TEXT,
+        source_url TEXT,
+        domain TEXT
+      );
+
+      -- FTS indexes
+      CREATE VIRTUAL TABLE IF NOT EXISTS functions_fts USING fts5(
+        name, signature, brief, description, params,
+        content='functions',
+        content_rowid='id'
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS kconfig_fts USING fts5(
+        name, prompt, help_text,
+        content='kconfig_symbols',
+        content_rowid='id'
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS dt_fts USING fts5(
+        compatible, description, properties,
+        content='dt_bindings',
+        content_rowid='id'
+      );
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS docs_fts USING fts5(
+        title, heading_path, body,
+        content='docs_chunks',
+        content_rowid='id'
+      );
+
+      -- Meta table for version tracking
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+    `);
+    }
+    // --- Insert helpers ---
+    insertFunction(row) {
+        const stmt = this.db.prepare(`INSERT INTO functions (name, signature, brief, description, params, return_type, return_desc, header, section, group_id)
+       VALUES (@name, @signature, @brief, @description, @params, @return_type, @return_desc, @header, @section, @group_id)`);
+        stmt.run({
+            name: row.name,
+            signature: row.signature,
+            brief: row.brief ?? null,
+            description: row.description ?? null,
+            params: row.params ?? null,
+            return_type: row.return_type ?? null,
+            return_desc: row.return_desc ?? null,
+            header: row.header ?? null,
+            section: row.section ?? null,
+            group_id: row.group_id ?? null,
+        });
+    }
+    insertFunctionsBatch(rows) {
+        const stmt = this.db.prepare(`INSERT INTO functions (name, signature, brief, description, params, return_type, return_desc, header, section, group_id)
+       VALUES (@name, @signature, @brief, @description, @params, @return_type, @return_desc, @header, @section, @group_id)`);
+        const txn = this.db.transaction((items) => {
+            for (const row of items) {
+                stmt.run({
+                    name: row.name,
+                    signature: row.signature,
+                    brief: row.brief ?? null,
+                    description: row.description ?? null,
+                    params: row.params ?? null,
+                    return_type: row.return_type ?? null,
+                    return_desc: row.return_desc ?? null,
+                    header: row.header ?? null,
+                    section: row.section ?? null,
+                    group_id: row.group_id ?? null,
+                });
+            }
+        });
+        txn(rows);
+    }
+    insertKconfig(row) {
+        const stmt = this.db.prepare(`INSERT INTO kconfig_symbols (name, type, prompt, default_val, depends_on, select_list, range_min, range_max, help_text, path)
+       VALUES (@name, @type, @prompt, @default_val, @depends_on, @select_list, @range_min, @range_max, @help_text, @path)`);
+        stmt.run({
+            name: row.name,
+            type: row.type ?? null,
+            prompt: row.prompt ?? null,
+            default_val: row.default_val ?? null,
+            depends_on: row.depends_on ?? null,
+            select_list: row.select_list ?? null,
+            range_min: row.range_min ?? null,
+            range_max: row.range_max ?? null,
+            help_text: row.help_text ?? null,
+            path: row.path ?? null,
+        });
+    }
+    insertKconfigsBatch(rows) {
+        const stmt = this.db.prepare(`INSERT INTO kconfig_symbols (name, type, prompt, default_val, depends_on, select_list, range_min, range_max, help_text, path)
+       VALUES (@name, @type, @prompt, @default_val, @depends_on, @select_list, @range_min, @range_max, @help_text, @path)`);
+        const txn = this.db.transaction((items) => {
+            for (const row of items) {
+                stmt.run({
+                    name: row.name,
+                    type: row.type ?? null,
+                    prompt: row.prompt ?? null,
+                    default_val: row.default_val ?? null,
+                    depends_on: row.depends_on ?? null,
+                    select_list: row.select_list ?? null,
+                    range_min: row.range_min ?? null,
+                    range_max: row.range_max ?? null,
+                    help_text: row.help_text ?? null,
+                    path: row.path ?? null,
+                });
+            }
+        });
+        txn(rows);
+    }
+    insertDtBinding(row) {
+        const stmt = this.db.prepare(`INSERT INTO dt_bindings (compatible, description, properties, child_binding, bus, on_bus, path)
+       VALUES (@compatible, @description, @properties, @child_binding, @bus, @on_bus, @path)`);
+        stmt.run({
+            compatible: row.compatible,
+            description: row.description ?? null,
+            properties: row.properties ?? null,
+            child_binding: row.child_binding ?? null,
+            bus: row.bus ?? null,
+            on_bus: row.on_bus ?? null,
+            path: row.path ?? null,
+        });
+    }
+    insertDtBindingsBatch(rows) {
+        const stmt = this.db.prepare(`INSERT INTO dt_bindings (compatible, description, properties, child_binding, bus, on_bus, path)
+       VALUES (@compatible, @description, @properties, @child_binding, @bus, @on_bus, @path)`);
+        const txn = this.db.transaction((items) => {
+            for (const row of items) {
+                stmt.run({
+                    compatible: row.compatible,
+                    description: row.description ?? null,
+                    properties: row.properties ?? null,
+                    child_binding: row.child_binding ?? null,
+                    bus: row.bus ?? null,
+                    on_bus: row.on_bus ?? null,
+                    path: row.path ?? null,
+                });
+            }
+        });
+        txn(rows);
+    }
+    insertDocChunk(row) {
+        const stmt = this.db.prepare(`INSERT INTO docs_chunks (title, heading_path, body, source_url, domain)
+       VALUES (@title, @heading_path, @body, @source_url, @domain)`);
+        stmt.run({
+            title: row.title ?? null,
+            heading_path: row.heading_path ?? null,
+            body: row.body ?? null,
+            source_url: row.source_url ?? null,
+            domain: row.domain ?? null,
+        });
+    }
+    insertDocChunksBatch(rows) {
+        const stmt = this.db.prepare(`INSERT INTO docs_chunks (title, heading_path, body, source_url, domain)
+       VALUES (@title, @heading_path, @body, @source_url, @domain)`);
+        const txn = this.db.transaction((items) => {
+            for (const row of items) {
+                stmt.run({
+                    title: row.title ?? null,
+                    heading_path: row.heading_path ?? null,
+                    body: row.body ?? null,
+                    source_url: row.source_url ?? null,
+                    domain: row.domain ?? null,
+                });
+            }
+        });
+        txn(rows);
+    }
+    // --- FTS rebuild ---
+    rebuildFts() {
+        this.db.exec(`
+      INSERT INTO functions_fts(rowid, name, signature, brief, description, params)
+        SELECT id, name, signature, brief, description, params FROM functions;
+      INSERT INTO kconfig_fts(rowid, name, prompt, help_text)
+        SELECT id, name, prompt, help_text FROM kconfig_symbols;
+      INSERT INTO dt_fts(rowid, compatible, description, properties)
+        SELECT id, compatible, description, properties FROM dt_bindings;
+      INSERT INTO docs_fts(rowid, title, heading_path, body)
+        SELECT id, title, heading_path, body FROM docs_chunks;
+    `);
+    }
+    // --- Meta ---
+    setMeta(key, value) {
+        this.db
+            .prepare("INSERT OR REPLACE INTO meta (key, value) VALUES (?, ?)")
+            .run(key, value);
+    }
+    getMeta(key) {
+        const row = this.db
+            .prepare("SELECT value FROM meta WHERE key = ?")
+            .get(key);
+        return row?.value;
+    }
+    /** Add FTS5 prefix wildcard to last token, and escape special characters. */
+    ftsQuery(query) {
+        const trimmed = query.trim();
+        if (trimmed.length === 0)
+            return query;
+        // Already escaped as a phrase or has wildcard — return as-is
+        if (trimmed.endsWith("*") || (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+            return trimmed;
+        }
+        // If query contains special FTS5 chars (,, , (, ), NEAR, etc.), treat as phrase
+        if (/[,()]/.test(trimmed)) {
+            return `"${trimmed}"`;
+        }
+        // Add prefix wildcard to last token
+        const tokens = trimmed.split(/\s+/);
+        if (tokens.length === 0)
+            return query;
+        tokens[tokens.length - 1] = tokens[tokens.length - 1] + "*";
+        return tokens.join(" ");
+    }
+    // --- Query helpers ---
+    getFunctionByName(name) {
+        return this.db
+            .prepare("SELECT * FROM functions WHERE name = ? ORDER BY id LIMIT 1")
+            .get(name);
+    }
+    getBindingByCompatible(compatible) {
+        return this.db
+            .prepare("SELECT * FROM dt_bindings WHERE compatible = ? ORDER BY id LIMIT 1")
+            .get(compatible);
+    }
+    searchFunctions(query, limit = 10) {
+        const fts = this.ftsQuery(query);
+        return this.db
+            .prepare(`SELECT f.* FROM functions_fts ft
+         JOIN functions f ON f.id = ft.rowid
+         WHERE functions_fts MATCH ?
+         ORDER BY rank
+         LIMIT ?`)
+            .all(fts, limit);
+    }
+    searchKconfig(query, limit = 10) {
+        const fts = this.ftsQuery(query);
+        return this.db
+            .prepare(`SELECT k.* FROM kconfig_fts ft
+         JOIN kconfig_symbols k ON k.id = ft.rowid
+         WHERE kconfig_fts MATCH ?
+         ORDER BY rank
+         LIMIT ?`)
+            .all(fts, limit);
+    }
+    searchBindings(query, limit = 10) {
+        const fts = this.ftsQuery(query);
+        return this.db
+            .prepare(`SELECT d.* FROM dt_fts ft
+         JOIN dt_bindings d ON d.id = ft.rowid
+         WHERE dt_fts MATCH ?
+         ORDER BY rank
+         LIMIT ?`)
+            .all(fts, limit);
+    }
+    searchDocs(query, limit = 10) {
+        const fts = this.ftsQuery(query);
+        return this.db
+            .prepare(`SELECT d.* FROM docs_fts ft
+         JOIN docs_chunks d ON d.id = ft.rowid
+         WHERE docs_fts MATCH ?
+         ORDER BY rank
+         LIMIT ?`)
+            .all(fts, limit);
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}