@zakstam/convex-docs-mcp 1.0.0

package/README.md

@@ -0,0 +1,18 @@
+# Convex Documentation MCP Server
+
+MCP server providing Claude Code with access to Convex documentation.
+
+## Installation
+
+```bash
+claude mcp add convex-docs -- npx -y @zakstam/convex-docs-mcp
+```
+
+On Windows (not WSL):
+```bash
+claude mcp add convex-docs -- cmd /c npx -y @zakstam/convex-docs-mcp
+```
+
+## License
+
+MIT

package/build/index.d.ts

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

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { listTopics, listTopicsSchema } from "./tools/listTopics.js";
+import { getPage, getPageSchema } from "./tools/getPage.js";
+import { search, searchSchema } from "./tools/search.js";
+const server = new Server({
+    name: "convex-docs",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "list_convex_topics",
+                description: "List all available Convex documentation sections and pages. Optionally filter by a specific section like 'functions', 'database', 'auth', etc.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        section: {
+                            type: "string",
+                            description: "Optional section to filter by (e.g., 'functions', 'database', 'auth')",
+                        },
+                    },
+                },
+            },
+            {
+                name: "get_convex_doc_page",
+                description: "Fetch and return a specific Convex documentation page as markdown. Provide either a path (e.g., 'functions/query-functions') or a full URL.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "The documentation page path (e.g., 'functions/query-functions') or full URL",
+                        },
+                    },
+                    required: ["path"],
+                },
+            },
+            {
+                name: "search_convex_docs",
+                description: "Search Convex documentation by keyword or topic. Returns matching pages with titles, URLs, and descriptions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search query to find relevant Convex documentation",
+                        },
+                    },
+                    required: ["query"],
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "list_convex_topics": {
+                const input = listTopicsSchema.parse(args);
+                const result = await listTopics(input);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "get_convex_doc_page": {
+                const input = getPageSchema.parse(args);
+                const result = await getPage(input);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `# ${result.title}\n\nSource: ${result.url}\n\n---\n\n${result.content}`,
+                        },
+                    ],
+                };
+            }
+            case "search_convex_docs": {
+                const input = searchSchema.parse(args);
+                const result = await search(input);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Convex Docs MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/build/tools/getPage.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+import type { DocPage } from "../types.js";
+export declare const getPageSchema: z.ZodObject<{
+    path: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+}, {
+    path: string;
+}>;
+export type GetPageInput = z.infer<typeof getPageSchema>;
+export declare function getPage(input: GetPageInput): Promise<DocPage>;
+//# sourceMappingURL=getPage.d.ts.map

package/build/tools/getPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPage.d.ts","sourceRoot":"","sources":["../../src/tools/getPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,eAAO,MAAM,aAAa;;;;;;EAMxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD,wBAAsB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnE"}

package/build/tools/getPage.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { fetchDocPage } from "../utils/fetcher.js";
+import { htmlToMarkdown, extractTitle } from "../utils/markdown.js";
+export const getPageSchema = z.object({
+    path: z
+        .string()
+        .describe("The documentation page path (e.g., 'functions/query-functions') or full URL"),
+});
+export async function getPage(input) {
+    const { html, url, cached } = await fetchDocPage(input.path);
+    const title = extractTitle(html);
+    const content = htmlToMarkdown(html);
+    // Log cache status to stderr for debugging
+    if (cached) {
+        console.error(`[cache hit] ${url}`);
+    }
+    else {
+        console.error(`[fetched] ${url}`);
+    }
+    return {
+        title,
+        path: input.path,
+        url,
+        content,
+    };
+}
+//# sourceMappingURL=getPage.js.map

package/build/tools/getPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPage.js","sourceRoot":"","sources":["../../src/tools/getPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CACP,6EAA6E,CAC9E;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAmB;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAErC,2CAA2C;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO;QACL,KAAK;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG;QACH,OAAO;KACR,CAAC;AACJ,CAAC"}

package/build/tools/listTopics.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const listTopicsSchema: z.ZodObject<{
+    section: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    section?: string | undefined;
+}, {
+    section?: string | undefined;
+}>;
+export type ListTopicsInput = z.infer<typeof listTopicsSchema>;
+interface TopicListItem {
+    title: string;
+    path: string;
+    url: string;
+    description?: string;
+    children?: TopicListItem[];
+}
+export declare function listTopics(input: ListTopicsInput): Promise<{
+    topics: TopicListItem[];
+    totalCount: number;
+}>;
+export {};
+//# sourceMappingURL=listTopics.d.ts.map

package/build/tools/listTopics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTopics.d.ts","sourceRoot":"","sources":["../../src/tools/listTopics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,gBAAgB;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAoBD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B1D"}

package/build/tools/listTopics.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { getAllTopics, filterTopicsBySection, DOCS_BASE_URL, } from "../utils/sitemap.js";
+export const listTopicsSchema = z.object({
+    section: z
+        .string()
+        .optional()
+        .describe("Optional section to filter by (e.g., 'functions', 'database')"),
+});
+function formatTopic(topic) {
+    const item = {
+        title: topic.title,
+        path: topic.path,
+        url: `${DOCS_BASE_URL}/${topic.path}`,
+    };
+    if (topic.description) {
+        item.description = topic.description;
+    }
+    if (topic.children && topic.children.length > 0) {
+        item.children = topic.children.map(formatTopic);
+    }
+    return item;
+}
+export async function listTopics(input) {
+    let topics;
+    if (input.section) {
+        topics = filterTopicsBySection(input.section);
+    }
+    else {
+        topics = getAllTopics();
+    }
+    const formattedTopics = topics.map(formatTopic);
+    // Count total topics including nested ones
+    function countTopics(items) {
+        let count = items.length;
+        for (const item of items) {
+            if (item.children) {
+                count += countTopics(item.children);
+            }
+        }
+        return count;
+    }
+    return {
+        topics: formattedTopics,
+        totalCount: countTopics(formattedTopics),
+    };
+}
+//# sourceMappingURL=listTopics.js.map

package/build/tools/listTopics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTopics.js","sourceRoot":"","sources":["../../src/tools/listTopics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC,CAAC;AAYH,SAAS,WAAW,CAAC,KAAe;IAClC,MAAM,IAAI,GAAkB;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,GAAG,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE;KACtC,CAAC;IAEF,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAsB;IAEtB,IAAI,MAAkB,CAAC;IAEvB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,YAAY,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAEhD,2CAA2C;IAC3C,SAAS,WAAW,CAAC,KAAsB;QACzC,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,UAAU,EAAE,WAAW,CAAC,eAAe,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/build/tools/search.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { SearchResult } from "../types.js";
+export declare const searchSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+export type SearchInput = z.infer<typeof searchSchema>;
+export declare function search(input: SearchInput): Promise<{
+    results: SearchResult[];
+    query: string;
+}>;
+//# sourceMappingURL=search.d.ts.map

package/build/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,eAAO,MAAM,YAAY;;;;;;EAEvB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEvD,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IACxD,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CA4DD"}

package/build/tools/search.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { searchTopics, DOCS_BASE_URL } from "../utils/sitemap.js";
+export const searchSchema = z.object({
+    query: z.string().describe("Search query to find relevant Convex documentation"),
+});
+export async function search(input) {
+    const { query } = input;
+    // Search through the local topic index
+    const matchingTopics = searchTopics(query);
+    // Score and format results
+    const results = matchingTopics.map((topic) => {
+        let score = 0;
+        const queryLower = query.toLowerCase();
+        const titleLower = topic.title.toLowerCase();
+        const pathLower = topic.path.toLowerCase();
+        const descLower = (topic.description || "").toLowerCase();
+        // Higher score for title matches
+        if (titleLower === queryLower) {
+            score += 100;
+        }
+        else if (titleLower.includes(queryLower)) {
+            score += 50;
+        }
+        // Score for path matches
+        if (pathLower.includes(queryLower)) {
+            score += 30;
+        }
+        // Score for description matches
+        if (descLower.includes(queryLower)) {
+            score += 20;
+        }
+        // Boost exact word matches
+        const queryWords = queryLower.split(/\s+/);
+        for (const word of queryWords) {
+            if (word.length > 2) {
+                if (titleLower.includes(word))
+                    score += 10;
+                if (pathLower.includes(word))
+                    score += 5;
+                if (descLower.includes(word))
+                    score += 5;
+            }
+        }
+        return {
+            title: topic.title,
+            path: topic.path,
+            url: `${DOCS_BASE_URL}/${topic.path}`,
+            snippet: topic.description || `Documentation page: ${topic.title}`,
+            score,
+        };
+    });
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    // Limit to top 10 results
+    const topResults = results.slice(0, 10);
+    return {
+        results: topResults,
+        query,
+    };
+}
+//# sourceMappingURL=search.js.map

package/build/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;CACjF,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAkB;IAI7C,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAExB,uCAAuC;IACvC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAE3C,2BAA2B;IAC3B,MAAM,OAAO,GAAmB,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAE1D,iCAAiC;QACjC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;aAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,yBAAyB;QACzB,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,gCAAgC;QAChC,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,2BAA2B;QAC3B,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,IAAI,EAAE,CAAC;gBAC3C,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,IAAI,CAAC,CAAC;gBACzC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,KAAK,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,EAAE,GAAG,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE;YACrC,OAAO,EAAE,KAAK,CAAC,WAAW,IAAI,uBAAuB,KAAK,CAAC,KAAK,EAAE;YAClE,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAE1C,0BAA0B;IAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,UAAU;QACnB,KAAK;KACN,CAAC;AACJ,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,25 @@
+export interface DocTopic {
+    title: string;
+    path: string;
+    description?: string;
+    children?: DocTopic[];
+}
+export interface SearchResult {
+    title: string;
+    path: string;
+    url: string;
+    snippet: string;
+    score: number;
+}
+export interface DocPage {
+    title: string;
+    path: string;
+    url: string;
+    content: string;
+}
+export interface FetchResult {
+    html: string;
+    url: string;
+    cached: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

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

package/build/utils/fetcher.d.ts

@@ -0,0 +1,9 @@
+import type { FetchResult } from "../types.js";
+export declare function buildDocUrl(path: string): string;
+export declare function fetchDocPage(path: string): Promise<FetchResult>;
+export declare function clearCache(): void;
+export declare function getCacheStats(): {
+    size: number;
+    urls: string[];
+};
+//# sourceMappingURL=fetcher.d.ts.map

package/build/utils/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/utils/fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBrE;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKhE"}

package/build/utils/fetcher.js

@@ -0,0 +1,39 @@
+import { DOCS_BASE_URL } from "./sitemap.js";
+const cache = new Map();
+const CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes
+export function buildDocUrl(path) {
+    const normalizedPath = path.replace(/^\/+|\/+$/g, "");
+    if (path.startsWith("http://") || path.startsWith("https://")) {
+        return path;
+    }
+    return `${DOCS_BASE_URL}/${normalizedPath}`;
+}
+export async function fetchDocPage(path) {
+    const url = buildDocUrl(path);
+    const cached = cache.get(url);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+        return { html: cached.html, url, cached: true };
+    }
+    const response = await fetch(url, {
+        headers: {
+            "User-Agent": "ConvexDocsMCPServer/1.0",
+            "Accept": "text/html,application/xhtml+xml",
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
+    }
+    const html = await response.text();
+    cache.set(url, { html, timestamp: Date.now() });
+    return { html, url, cached: false };
+}
+export function clearCache() {
+    cache.clear();
+}
+export function getCacheStats() {
+    return {
+        size: cache.size,
+        urls: Array.from(cache.keys()),
+    };
+}
+//# sourceMappingURL=fetcher.js.map

package/build/utils/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../src/utils/fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+C,CAAC;AACrE,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAElD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAEtD,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,aAAa,IAAI,cAAc,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,YAAY,EAAE,yBAAyB;YACvC,QAAQ,EAAE,iCAAiC;SAC5C;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEnC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEhD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;KAC/B,CAAC;AACJ,CAAC"}

package/build/utils/markdown.d.ts

@@ -0,0 +1,5 @@
+export declare function extractMainContent(html: string): string;
+export declare function extractTitle(html: string): string;
+export declare function htmlToMarkdown(html: string): string;
+export declare function createSnippet(text: string, maxLength?: number): string;
+//# sourceMappingURL=markdown.d.ts.map

package/build/utils/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAoCA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6CvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAiB3E"}

package/build/utils/markdown.js

@@ -0,0 +1,108 @@
+import TurndownService from "turndown";
+const turndown = new TurndownService({
+    headingStyle: "atx",
+    codeBlockStyle: "fenced",
+    bulletListMarker: "-",
+});
+// Customize code block handling for better output
+turndown.addRule("fencedCodeBlock", {
+    filter: (node) => {
+        return (node.nodeName === "PRE" &&
+            node.firstChild !== null &&
+            node.firstChild.nodeName === "CODE");
+    },
+    replacement: (_content, node) => {
+        const codeNode = node.firstChild;
+        const className = codeNode.getAttribute("class") || "";
+        const langMatch = className.match(/language-(\w+)/);
+        const lang = langMatch ? langMatch[1] : "";
+        const code = codeNode.textContent || "";
+        return `\n\`\`\`${lang}\n${code}\n\`\`\`\n`;
+    },
+});
+// Remove certain elements that are not useful in markdown
+turndown.remove(["script", "style", "nav", "footer", "header", "aside", "button", "noscript"]);
+// Add rule to remove SVG elements
+turndown.addRule("removeSvg", {
+    filter: (node) => node.nodeName === "SVG",
+    replacement: () => "",
+});
+export function extractMainContent(html) {
+    // Try to extract the main content area
+    // Convex docs typically have content in <main> or an article element
+    // Look for main content patterns
+    const mainPatterns = [
+        /<main[^>]*>([\s\S]*?)<\/main>/i,
+        /<article[^>]*>([\s\S]*?)<\/article>/i,
+        /<div[^>]*class="[^"]*content[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
+        /<div[^>]*id="[^"]*content[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
+    ];
+    for (const pattern of mainPatterns) {
+        const match = html.match(pattern);
+        if (match && match[1]) {
+            return match[1];
+        }
+    }
+    // If no main content found, try to clean up the HTML
+    // Remove obvious non-content elements
+    let cleaned = html;
+    // Remove head section
+    cleaned = cleaned.replace(/<head[\s\S]*?<\/head>/gi, "");
+    // Remove navigation
+    cleaned = cleaned.replace(/<nav[\s\S]*?<\/nav>/gi, "");
+    // Remove footer
+    cleaned = cleaned.replace(/<footer[\s\S]*?<\/footer>/gi, "");
+    // Remove header
+    cleaned = cleaned.replace(/<header[\s\S]*?<\/header>/gi, "");
+    // Remove aside elements (sidebars)
+    cleaned = cleaned.replace(/<aside[\s\S]*?<\/aside>/gi, "");
+    // Remove script tags
+    cleaned = cleaned.replace(/<script[\s\S]*?<\/script>/gi, "");
+    // Remove style tags
+    cleaned = cleaned.replace(/<style[\s\S]*?<\/style>/gi, "");
+    return cleaned;
+}
+export function extractTitle(html) {
+    // Try to extract the page title
+    const titlePatterns = [
+        /<title[^>]*>([^<]*)<\/title>/i,
+        /<h1[^>]*>([^<]*)<\/h1>/i,
+    ];
+    for (const pattern of titlePatterns) {
+        const match = html.match(pattern);
+        if (match && match[1]) {
+            // Clean up the title
+            let title = match[1].trim();
+            // Remove common suffixes like " | Convex Docs"
+            title = title.replace(/\s*[|–-]\s*Convex.*$/i, "");
+            return title;
+        }
+    }
+    return "Untitled";
+}
+export function htmlToMarkdown(html) {
+    const mainContent = extractMainContent(html);
+    const markdown = turndown.turndown(mainContent);
+    // Clean up excessive whitespace
+    let cleaned = markdown
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/^\s+|\s+$/g, "");
+    return cleaned;
+}
+export function createSnippet(text, maxLength = 200) {
+    // Remove markdown formatting for snippet
+    let snippet = text
+        .replace(/```[\s\S]*?```/g, "") // Remove code blocks
+        .replace(/`[^`]+`/g, "") // Remove inline code
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // Remove links, keep text
+        .replace(/#+\s*/g, "") // Remove heading markers
+        .replace(/[*_~]+/g, "") // Remove emphasis markers
+        .replace(/\n+/g, " ") // Replace newlines with spaces
+        .replace(/\s+/g, " ") // Collapse whitespace
+        .trim();
+    if (snippet.length > maxLength) {
+        snippet = snippet.substring(0, maxLength - 3) + "...";
+    }
+    return snippet;
+}
+//# sourceMappingURL=markdown.js.map

package/build/utils/markdown.js.map

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

package/build/utils/sitemap.d.ts

@@ -0,0 +1,9 @@
+import type { DocTopic } from "../types.js";
+export declare const DOCS_BASE_URL = "https://docs.convex.dev";
+export declare const docsSitemap: DocTopic[];
+export declare function getAllTopics(): DocTopic[];
+export declare function getTopicByPath(path: string): DocTopic | undefined;
+export declare function filterTopicsBySection(section: string): DocTopic[];
+export declare function flattenTopics(topics?: DocTopic[]): DocTopic[];
+export declare function searchTopics(query: string): DocTopic[];
+//# sourceMappingURL=sitemap.d.ts.map

package/build/utils/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/utils/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,aAAa,4BAA4B,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,QAAQ,EAmJjC,CAAC;AAEF,wBAAgB,YAAY,IAAI,QAAQ,EAAE,CAEzC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAiBjE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAQjE;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAE,QAAQ,EAAgB,GAAG,QAAQ,EAAE,CAc1E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUtD"}

package/build/utils/sitemap.js

@@ -0,0 +1,195 @@
+export const DOCS_BASE_URL = "https://docs.convex.dev";
+export const docsSitemap = [
+    {
+        title: "Get Started",
+        path: "get-started",
+        description: "Introduction and getting started with Convex",
+        children: [
+            { title: "Welcome", path: "get-started", description: "Introduction to Convex" },
+            { title: "Tutorial", path: "tutorial", description: "Step-by-step Convex tutorial" },
+            {
+                title: "Quickstarts",
+                path: "quickstarts",
+                description: "Quick start guides for various frameworks",
+                children: [
+                    { title: "React", path: "quickstarts/react", description: "Quickstart with React" },
+                    { title: "Next.js", path: "quickstarts/nextjs", description: "Quickstart with Next.js" },
+                    { title: "React Native", path: "quickstarts/react-native", description: "Quickstart with React Native" },
+                    { title: "Vue", path: "quickstarts/vue", description: "Quickstart with Vue" },
+                    { title: "Svelte", path: "quickstarts/svelte", description: "Quickstart with Svelte" },
+                    { title: "Python", path: "quickstarts/python", description: "Quickstart with Python" },
+                    { title: "Rust", path: "quickstarts/rust", description: "Quickstart with Rust" },
+                ],
+            },
+        ],
+    },
+    {
+        title: "Functions",
+        path: "functions",
+        description: "Convex serverless functions",
+        children: [
+            { title: "Overview", path: "functions", description: "Introduction to Convex functions" },
+            { title: "Query Functions", path: "functions/query-functions", description: "Read data with query functions" },
+            { title: "Mutation Functions", path: "functions/mutation-functions", description: "Write data with mutation functions" },
+            { title: "Action Functions", path: "functions/actions", description: "Side effects with action functions" },
+            { title: "Internal Functions", path: "functions/internal-functions", description: "Functions only callable from other functions" },
+            { title: "HTTP Actions", path: "functions/http-actions", description: "HTTP endpoint handlers" },
+            { title: "Bundling", path: "functions/bundling", description: "How function bundling works" },
+            { title: "Error Handling", path: "functions/error-handling", description: "Handling errors in functions" },
+        ],
+    },
+    {
+        title: "Database",
+        path: "database",
+        description: "Convex database and data modeling",
+        children: [
+            { title: "Overview", path: "database", description: "Introduction to Convex database" },
+            { title: "Reading Data", path: "database/reading-data", description: "Querying data from the database" },
+            { title: "Writing Data", path: "database/writing-data", description: "Inserting and modifying data" },
+            { title: "Document IDs", path: "database/document-ids", description: "Working with document IDs" },
+            { title: "Tables", path: "database/tables", description: "Database tables and collections" },
+            { title: "Schemas", path: "database/schemas", description: "Defining database schemas" },
+            { title: "Indexes", path: "database/indexes", description: "Database indexes for efficient queries" },
+            { title: "Pagination", path: "database/pagination", description: "Paginating query results" },
+            { title: "TypeScript", path: "database/typescript", description: "TypeScript support for database" },
+        ],
+    },
+    {
+        title: "File Storage",
+        path: "file-storage",
+        description: "Storing and serving files",
+        children: [
+            { title: "Overview", path: "file-storage", description: "Introduction to file storage" },
+            { title: "Upload Files", path: "file-storage/upload-files", description: "Uploading files to Convex" },
+            { title: "Serve Files", path: "file-storage/serve-files", description: "Serving files from Convex" },
+            { title: "Delete Files", path: "file-storage/delete-files", description: "Deleting stored files" },
+        ],
+    },
+    {
+        title: "Authentication",
+        path: "auth",
+        description: "User authentication and authorization",
+        children: [
+            { title: "Overview", path: "auth", description: "Introduction to authentication" },
+            { title: "Clerk", path: "auth/clerk", description: "Authentication with Clerk" },
+            { title: "Auth0", path: "auth/auth0", description: "Authentication with Auth0" },
+            { title: "Custom Auth", path: "auth/custom-auth", description: "Custom authentication setup" },
+            { title: "Functions Auth", path: "auth/functions-auth", description: "Authentication in functions" },
+        ],
+    },
+    {
+        title: "Scheduling",
+        path: "scheduling",
+        description: "Scheduled and cron jobs",
+        children: [
+            { title: "Overview", path: "scheduling", description: "Introduction to scheduling" },
+            { title: "Scheduled Functions", path: "scheduling/scheduled-functions", description: "Running functions on a schedule" },
+            { title: "Cron Jobs", path: "scheduling/cron-jobs", description: "Setting up cron jobs" },
+        ],
+    },
+    {
+        title: "Search",
+        path: "search",
+        description: "Full-text and vector search",
+        children: [
+            { title: "Overview", path: "search", description: "Introduction to search" },
+            { title: "Full-Text Search", path: "search/full-text-search", description: "Full-text search implementation" },
+            { title: "Vector Search", path: "search/vector-search", description: "Vector/semantic search implementation" },
+        ],
+    },
+    {
+        title: "AI",
+        path: "ai",
+        description: "AI and LLM integration",
+        children: [
+            { title: "Overview", path: "ai", description: "AI features in Convex" },
+        ],
+    },
+    {
+        title: "Client Libraries",
+        path: "client",
+        description: "Client-side libraries and SDKs",
+        children: [
+            { title: "React", path: "client/react", description: "React client library" },
+            { title: "React Native", path: "client/react-native", description: "React Native client" },
+            { title: "JavaScript", path: "client/javascript", description: "Vanilla JavaScript client" },
+            { title: "Python", path: "client/python", description: "Python client library" },
+        ],
+    },
+    {
+        title: "Production",
+        path: "production",
+        description: "Deployment and production considerations",
+        children: [
+            { title: "Overview", path: "production", description: "Production deployment" },
+            { title: "Hosting", path: "production/hosting", description: "Hosting your Convex app" },
+            { title: "Environment Variables", path: "production/environment-variables", description: "Managing environment variables" },
+            { title: "Logging", path: "production/logging", description: "Application logging" },
+            { title: "Error Handling", path: "production/error-handling", description: "Production error handling" },
+            { title: "Debugging", path: "production/debugging", description: "Debugging production issues" },
+            { title: "Best Practices", path: "production/best-practices", description: "Production best practices" },
+        ],
+    },
+    {
+        title: "CLI",
+        path: "cli",
+        description: "Convex CLI reference",
+        children: [
+            { title: "Overview", path: "cli", description: "Convex CLI introduction" },
+        ],
+    },
+    {
+        title: "API Reference",
+        path: "api",
+        description: "Complete API reference",
+        children: [
+            { title: "Overview", path: "api", description: "API reference overview" },
+        ],
+    },
+];
+export function getAllTopics() {
+    return docsSitemap;
+}
+export function getTopicByPath(path) {
+    const normalizedPath = path.replace(/^\/+|\/+$/g, "");
+    function findTopic(topics) {
+        for (const topic of topics) {
+            if (topic.path === normalizedPath) {
+                return topic;
+            }
+            if (topic.children) {
+                const found = findTopic(topic.children);
+                if (found)
+                    return found;
+            }
+        }
+        return undefined;
+    }
+    return findTopic(docsSitemap);
+}
+export function filterTopicsBySection(section) {
+    const normalizedSection = section.toLowerCase().replace(/[\s-]+/g, "-");
+    return docsSitemap.filter((topic) => topic.path.toLowerCase().includes(normalizedSection) ||
+        topic.title.toLowerCase().replace(/[\s]+/g, "-").includes(normalizedSection));
+}
+export function flattenTopics(topics = docsSitemap) {
+    const result = [];
+    function flatten(items) {
+        for (const item of items) {
+            result.push({ title: item.title, path: item.path, description: item.description });
+            if (item.children) {
+                flatten(item.children);
+            }
+        }
+    }
+    flatten(topics);
+    return result;
+}
+export function searchTopics(query) {
+    const normalizedQuery = query.toLowerCase();
+    const allTopics = flattenTopics();
+    return allTopics.filter((topic) => topic.title.toLowerCase().includes(normalizedQuery) ||
+        topic.path.toLowerCase().includes(normalizedQuery) ||
+        (topic.description && topic.description.toLowerCase().includes(normalizedQuery)));
+}
+//# sourceMappingURL=sitemap.js.map

package/build/utils/sitemap.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@zakstam/convex-docs-mcp",
+  "version": "1.0.0",
+  "description": "MCP server providing access to Convex documentation",
+  "main": "build/index.js",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zakstam/convex-docs-mcp.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true,
+    "access": "public"
+  },
+  "files": [
+    "build"
+  ],
+  "bin": {
+    "convex-docs-mcp": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsc --watch",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "mcp",
+    "convex",
+    "documentation"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "turndown": "^7.1.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/node": "^20.0.0",
+    "@types/turndown": "^5.0.0",
+    "husky": "^9.1.7",
+    "semantic-release": "^25.0.2",
+    "typescript": "^5.0.0"
+  }
+}