slicejs-mcp 1.0.0

package/README.md

@@ -0,0 +1,154 @@
+# Slice.js Documentation MCP
+
+An MCP (Model Context Protocol) server that provides access to Slice.js documentation from the official GitHub repository. This server allows AI assistants and tools to query, search, and retrieve documentation seamlessly.
+
+## Features
+
+- **Dynamic Documentation Discovery**: Automatically discovers and indexes all documentation files from the GitHub repo
+- **Intelligent Caching**: Infinite session cache to minimize API requests and improve performance
+- **Full-Text Search**: Search across all documentation with keyword matching
+- **Content Retrieval**: Fetch specific documentation pages or the complete documentation bundle
+- **Lazy Initialization**: Docs structure is loaded on-demand when first needed
+
+## Installation
+
+### Global Installation (Recommended)
+```bash
+npm install -g slicejs-mcp
+```
+
+### Using npx (No Installation Required)
+```bash
+npx slicejs-mcp
+```
+
+## Usage
+
+The MCP server runs as a stdio-based service, perfect for integration with AI assistants and MCP-compatible tools.
+
+### Basic Usage
+```bash
+npx slicejs-mcp
+```
+
+### Integration with MCP Clients
+This server is designed to work with MCP-compatible clients. When launched, it exposes 4 tools:
+
+## Tools
+
+### 1. `list_docs`
+Returns a list of all available documentation sections and categories.
+
+**Parameters:** None
+
+**Response:** JSON array of documentation items with id, title, and path.
+
+**Example:**
+```json
+[
+  {
+    "id": "getting-started",
+    "title": "Getting Started",
+    "path": "markdown/getting-started.md"
+  }
+]
+```
+
+### 2. `search_docs`
+Searches across all documentation using keywords or phrases.
+
+**Parameters:**
+- `query` (string, required): Search term
+- `max_results` (number, optional, default: 5): Maximum number of results
+
+**Response:** JSON array of search results with snippets and metadata.
+
+### 3. `get_doc_content`
+Fetches the full content of specific documentation page(s).
+
+**Parameters:**
+- `doc_id` (string or string[], required): Documentation ID(s) to fetch
+- `include_metadata` (boolean, optional, default: false): Include additional metadata
+
+**Response:** JSON object(s) with document content, title, and optional metadata.
+
+### 4. `get_llm_full_context`
+Fetches the complete documentation bundle (~2000 lines) for comprehensive LLM context.
+
+**Parameters:** None
+
+**Response:** Complete documentation text
+
+**Note:** This consumes considerable tokens but provides all documentation in one request.
+
+## Examples
+
+### List all documentation
+```javascript
+// Via MCP client
+await callTool("list_docs", {});
+```
+
+### Search for routing information
+```javascript
+await callTool("search_docs", {
+  query: "routing",
+  max_results: 3
+});
+```
+
+### Get specific documentation
+```javascript
+await callTool("get_doc_content", {
+  doc_id: "getting-started/routing"
+});
+```
+
+### Get full documentation context
+```javascript
+await callTool("get_llm_full_context", {});
+```
+
+## Architecture
+
+- **Source**: Documentation fetched from https://github.com/VKneider/slicejs_docs
+- **Caching**: Infinite session cache prevents redundant API calls
+- **Initialization**: Lazy loading of document structure on first tool use
+- **Rate Limiting**: Optimized to stay within GitHub API limits (60 req/hour)
+
+## Development
+
+### Prerequisites
+- Node.js >= 18
+- npm or yarn
+
+### Setup
+```bash
+git clone <repo>
+cd slicejs-mcp
+npm install
+npm run build
+```
+
+### Running Locally
+```bash
+npm start
+# or
+node dist/index.js
+```
+
+### Testing with MCP Inspector
+```bash
+npx @modelcontextprotocol/inspector node dist/index.js
+```
+
+## Contributing
+
+Contributions welcome! Please ensure:
+- All tools maintain backward compatibility
+- Cache behavior is preserved
+- Error handling is robust
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+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":""}

package/dist/index.js

@@ -0,0 +1,17 @@
+import { FastMCP } from "fastmcp";
+import { listDocsTool } from "./tools/list-docs.js";
+import { searchDocsTool } from "./tools/search-docs.js";
+import { getDocContentTool } from "./tools/get-doc-content.js";
+import { getLlmFullContextTool } from "./tools/get-llm-full-context.js";
+const server = new FastMCP({
+    name: "Slice.js Documentation MCP",
+    version: "1.0.0",
+});
+server.addTool(listDocsTool);
+server.addTool(searchDocsTool);
+server.addTool(getDocContentTool);
+server.addTool(getLlmFullContextTool);
+server.start({
+    transportType: "stdio",
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC;IACzB,IAAI,EAAE,4BAA4B;IAClC,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAC7B,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;AAC/B,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAClC,MAAM,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEtC,MAAM,CAAC,KAAK,CAAC;IACX,aAAa,EAAE,OAAO;CACvB,CAAC,CAAC"}

package/dist/tools/get-doc-content.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const getDocContentTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        doc_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        include_metadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        doc_id: string | string[];
+        include_metadata: boolean;
+    }, {
+        doc_id: string | string[];
+        include_metadata?: boolean | undefined;
+    }>;
+    execute: (args: {
+        doc_id: string | string[];
+        include_metadata: boolean;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=get-doc-content.d.ts.map

package/dist/tools/get-doc-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-doc-content.d.ts","sourceRoot":"","sources":["../../src/tools/get-doc-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;oBAON;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE;CA+B/E,CAAC"}

package/dist/tools/get-doc-content.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, fetchDocContent, initializeDocsStructure, isInitialized } from "../utils.js";
+export const getDocContentTool = {
+    name: "get_doc_content",
+    description: "Fetches full content of specific doc page(s)",
+    parameters: z.object({
+        doc_id: z.union([z.string(), z.array(z.string())]),
+        include_metadata: z.boolean().optional().default(false),
+    }),
+    execute: async (args) => {
+        if (!isInitialized)
+            await initializeDocsStructure();
+        const { doc_id, include_metadata } = args;
+        const ids = Array.isArray(doc_id) ? doc_id : [doc_id];
+        const results = [];
+        for (const id of ids) {
+            const doc = DOCS_STRUCTURE.find(d => d.id === id);
+            if (!doc)
+                continue;
+            const content = await fetchDocContent(id);
+            if (!content)
+                continue;
+            const result = {
+                doc_id: id,
+                title: doc.title,
+                content,
+            };
+            if (include_metadata) {
+                result.metadata = {
+                    path: doc.path,
+                    fetched_at: new Date().toISOString(),
+                };
+            }
+            results.push(result);
+        }
+        return JSON.stringify(results.length === 1 ? results[0] : results);
+    },
+};
+//# sourceMappingURL=get-doc-content.js.map

package/dist/tools/get-doc-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-doc-content.js","sourceRoot":"","sources":["../../src/tools/get-doc-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,8CAA8C;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACxD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAA8D,EAAE,EAAE;QAChF,IAAI,CAAC,aAAa;YAAE,MAAM,uBAAuB,EAAE,CAAC;QACpD,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAU,EAAE,CAAC;QAE1B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG;gBAAE,SAAS;YAEnB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,MAAM,GAAQ;gBAClB,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO;aACR,CAAC;YAEF,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,GAAG;oBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACrC,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CACF,CAAC"}

package/dist/tools/get-documentation.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const getDocumentationTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        doc_id: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>;
+        include_metadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        doc_id: string | string[];
+        include_metadata: boolean;
+    }, {
+        doc_id: string | string[];
+        include_metadata?: boolean | undefined;
+    }>;
+    execute: (args: {
+        doc_id: string | string[];
+        include_metadata: boolean;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=get-documentation.d.ts.map

package/dist/tools/get-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/get-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;oBAOT;QAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE;CA8B/E,CAAC"}

package/dist/tools/get-documentation.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, fetchDocContent } from "../utils.js";
+export const getDocumentationTool = {
+    name: "get_documentation",
+    description: "Fetches full content of specific doc page(s)",
+    parameters: z.object({
+        doc_id: z.union([z.string(), z.array(z.string())]),
+        include_metadata: z.boolean().optional().default(false),
+    }),
+    execute: async (args) => {
+        const { doc_id, include_metadata } = args;
+        const ids = Array.isArray(doc_id) ? doc_id : [doc_id];
+        const results = [];
+        for (const id of ids) {
+            const doc = DOCS_STRUCTURE.find(d => d.id === id);
+            if (!doc)
+                continue;
+            const content = await fetchDocContent(id);
+            if (!content)
+                continue;
+            const result = {
+                doc_id: id,
+                title: doc.title,
+                content,
+            };
+            if (include_metadata) {
+                result.metadata = {
+                    path: doc.path,
+                    fetched_at: new Date().toISOString(),
+                };
+            }
+            results.push(result);
+        }
+        return JSON.stringify(results.length === 1 ? results[0] : results);
+    },
+};
+//# sourceMappingURL=get-documentation.js.map

package/dist/tools/get-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-documentation.js","sourceRoot":"","sources":["../../src/tools/get-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,8CAA8C;IAC3D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAClD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACxD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAA8D,EAAE,EAAE;QAChF,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAU,EAAE,CAAC;QAE1B,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG;gBAAE,SAAS;YAEnB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,MAAM,GAAQ;gBAClB,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,OAAO;aACR,CAAC;YAEF,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,GAAG;oBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACrC,CAAC;YACJ,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrE,CAAC;CACF,CAAC"}

package/dist/tools/get-llm-context.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const getLlmContextTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: () => Promise<string>;
+};
+//# sourceMappingURL=get-llm-context.d.ts.map

package/dist/tools/get-llm-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-llm-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-llm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB;;;;;CAmB7B,CAAC"}

package/dist/tools/get-llm-context.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { getCached, setCache, BASE_URL } from "../utils.js";
+export const getLlmContextTool = {
+    name: "get_llm_context",
+    description: "Fetches the complete llm.txt from the repository",
+    parameters: z.object({}),
+    execute: async () => {
+        const cached = getCached('llm.txt');
+        if (cached)
+            return cached;
+        const url = `${BASE_URL}llm.txt`;
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const content = await response.text();
+            setCache('llm.txt', content);
+            return content;
+        }
+        catch (error) {
+            return `Error fetching llm.txt: ${error}`;
+        }
+    },
+};
+//# sourceMappingURL=get-llm-context.js.map

package/dist/tools/get-llm-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-llm-context.js","sourceRoot":"","sources":["../../src/tools/get-llm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,kDAAkD;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,GAAG,GAAG,GAAG,QAAQ,SAAS,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,2BAA2B,KAAK,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/get-llm-full-context.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const getLlmFullContextTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: () => Promise<string>;
+};
+//# sourceMappingURL=get-llm-full-context.d.ts.map

package/dist/tools/get-llm-full-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-llm-full-context.d.ts","sourceRoot":"","sources":["../../src/tools/get-llm-full-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;CAmBjC,CAAC"}

package/dist/tools/get-llm-full-context.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { getCached, setCache, BASE_URL } from "../utils.js";
+export const getLlmFullContextTool = {
+    name: "get_llm_full_context",
+    description: "Fetches the complete llm.txt from the repository (~2000 lines, consumes considerable tokens but provides all documentation in one go)",
+    parameters: z.object({}),
+    execute: async () => {
+        const cached = getCached('llm.txt');
+        if (cached)
+            return cached;
+        const url = `${BASE_URL}llm.txt`;
+        try {
+            const response = await fetch(url);
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            const content = await response.text();
+            setCache('llm.txt', content);
+            return content;
+        }
+        catch (error) {
+            return `Error fetching llm.txt: ${error}`;
+        }
+    },
+};
+//# sourceMappingURL=get-llm-full-context.js.map

package/dist/tools/get-llm-full-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-llm-full-context.js","sourceRoot":"","sources":["../../src/tools/get-llm-full-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,uIAAuI;IACpJ,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,GAAG,GAAG,GAAG,QAAQ,SAAS,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,2BAA2B,KAAK,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/list-docs.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const listDocsTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: () => Promise<string>;
+};
+//# sourceMappingURL=list-docs.d.ts.map

package/dist/tools/list-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-docs.d.ts","sourceRoot":"","sources":["../../src/tools/list-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;CAYxB,CAAC"}

package/dist/tools/list-docs.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, initializeDocsStructure, isInitialized } from "../utils.js";
+export const listDocsTool = {
+    name: "list_docs",
+    description: "Returns available documentation sections/categories",
+    parameters: z.object({}),
+    execute: async () => {
+        if (!isInitialized)
+            await initializeDocsStructure();
+        return JSON.stringify(DOCS_STRUCTURE.map(doc => ({
+            id: doc.id,
+            title: doc.title,
+            path: doc.path,
+        })));
+    },
+};
+//# sourceMappingURL=list-docs.js.map

package/dist/tools/list-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-docs.js","sourceRoot":"","sources":["../../src/tools/list-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,qDAAqD;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC,aAAa;YAAE,MAAM,uBAAuB,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/tools/list-documentation.d.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export declare const listDocumentationTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: () => Promise<string>;
+};
+//# sourceMappingURL=list-documentation.d.ts.map

package/dist/tools/list-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/list-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;CAYjC,CAAC"}

package/dist/tools/list-documentation.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, initializeDocsStructure } from "../utils.js";
+export const listDocumentationTool = {
+    name: "list_documentation",
+    description: "Returns available documentation sections/categories",
+    parameters: z.object({}),
+    execute: async () => {
+        await initializeDocsStructure();
+        return JSON.stringify(DOCS_STRUCTURE.map(doc => ({
+            id: doc.id,
+            title: doc.title,
+            path: doc.path,
+        })));
+    },
+};
+//# sourceMappingURL=list-documentation.js.map

package/dist/tools/list-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documentation.js","sourceRoot":"","sources":["../../src/tools/list-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,qDAAqD;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,uBAAuB,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC"}

package/dist/tools/search-docs.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const searchDocsTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        query: z.ZodString;
+        max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        max_results: number;
+    }, {
+        query: string;
+        max_results?: number | undefined;
+    }>;
+    execute: (args: {
+        query: string;
+        max_results: number;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=search-docs.d.ts.map

package/dist/tools/search-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;oBAOH;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CA6B7D,CAAC"}

package/dist/tools/search-docs.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, fetchDocContent, initializeDocsStructure, isInitialized } from "../utils.js";
+export const searchDocsTool = {
+    name: "search_docs",
+    description: "Searches across all docs by keyword/phrase",
+    parameters: z.object({
+        query: z.string(),
+        max_results: z.number().optional().default(5),
+    }),
+    execute: async (args) => {
+        if (!isInitialized)
+            await initializeDocsStructure();
+        const { query, max_results } = args;
+        const results = [];
+        for (const doc of DOCS_STRUCTURE) {
+            const content = await fetchDocContent(doc.id);
+            if (!content)
+                continue;
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (line.toLowerCase().includes(query.toLowerCase())) {
+                    const snippet = line.trim();
+                    results.push({
+                        doc_id: doc.id,
+                        title: doc.title,
+                        relevance_score: 1, // simple match
+                        snippet,
+                        path: doc.path,
+                    });
+                    if (results.length >= max_results)
+                        break;
+                }
+            }
+            if (results.length >= max_results)
+                break;
+        }
+        return JSON.stringify(results);
+    },
+};
+//# sourceMappingURL=search-docs.js.map

package/dist/tools/search-docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEtG,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,4CAA4C;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KAC9C,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAA4C,EAAE,EAAE;QAC9D,IAAI,CAAC,aAAa;YAAE,MAAM,uBAAuB,EAAE,CAAC;QACpD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QACpC,MAAM,OAAO,GAAU,EAAE,CAAC;QAE1B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,GAAG,CAAC,EAAE;wBACd,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,eAAe,EAAE,CAAC,EAAE,eAAe;wBACnC,OAAO;wBACP,IAAI,EAAE,GAAG,CAAC,IAAI;qBACf,CAAC,CAAC;oBACH,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW;wBAAE,MAAM;gBAC3C,CAAC;YACH,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW;gBAAE,MAAM;QAC3C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;CACF,CAAC"}

package/dist/tools/search-documentation.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const searchDocumentationTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        query: z.ZodString;
+        max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        max_results: number;
+    }, {
+        query: string;
+        max_results?: number | undefined;
+    }>;
+    execute: (args: {
+        query: string;
+        max_results: number;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=search-documentation.d.ts.map

package/dist/tools/search-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.d.ts","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;oBAOZ;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CA4B7D,CAAC"}

package/dist/tools/search-documentation.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { DOCS_STRUCTURE, fetchDocContent } from "../utils.js";
+export const searchDocumentationTool = {
+    name: "search_documentation",
+    description: "Searches across all docs by keyword/phrase",
+    parameters: z.object({
+        query: z.string(),
+        max_results: z.number().optional().default(5),
+    }),
+    execute: async (args) => {
+        const { query, max_results } = args;
+        const results = [];
+        for (const doc of DOCS_STRUCTURE) {
+            const content = await fetchDocContent(doc.id);
+            if (!content)
+                continue;
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (line.toLowerCase().includes(query.toLowerCase())) {
+                    const snippet = line.trim();
+                    results.push({
+                        doc_id: doc.id,
+                        title: doc.title,
+                        relevance_score: 1, // simple match
+                        snippet,
+                        path: doc.path,
+                    });
+                    if (results.length >= max_results)
+                        break;
+                }
+            }
+            if (results.length >= max_results)
+                break;
+        }
+        return JSON.stringify(results);
+    },
+};
+//# sourceMappingURL=search-documentation.js.map

package/dist/tools/search-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documentation.js","sourceRoot":"","sources":["../../src/tools/search-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,4CAA4C;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KAC9C,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAA4C,EAAE,EAAE;QAC9D,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QACpC,MAAM,OAAO,GAAU,EAAE,CAAC;QAE1B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,GAAG,CAAC,EAAE;wBACd,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,eAAe,EAAE,CAAC,EAAE,eAAe;wBACnC,OAAO;wBACP,IAAI,EAAE,GAAG,CAAC,IAAI;qBACf,CAAC,CAAC;oBACH,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW;wBAAE,MAAM;gBAC3C,CAAC;YACH,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW;gBAAE,MAAM;QAC3C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;CACF,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,20 @@
+export declare const cache: Map<string, {
+    content: string;
+    timestamp: number;
+}>;
+export declare const CACHE_TTL: number;
+export declare function getCached(key: string): string | null;
+export declare function setCache(key: string, content: string): void;
+export declare const BASE_URL = "https://raw.githubusercontent.com/VKneider/slicejs_docs/master/";
+export declare const API_BASE = "https://api.github.com/repos/VKneider/slicejs_docs/contents/";
+export interface DocItem {
+    id: string;
+    path: string;
+    title: string;
+    description?: string;
+}
+export declare let DOCS_STRUCTURE: DocItem[];
+export declare let isInitialized: boolean;
+export declare function initializeDocsStructure(): Promise<void>;
+export declare function fetchDocContent(docId: string): Promise<string | null>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,KAAK;aAA8B,MAAM;eAAa,MAAM;EAAK,CAAC;AAC/E,eAAO,MAAM,SAAS,QAAW,CAAC;AAElC,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUpD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,eAAO,MAAM,QAAQ,oEAAoE,CAAC;AAC1F,eAAO,MAAM,QAAQ,iEAAiE,CAAC;AAEvF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,eAAO,IAAI,cAAc,EAAE,OAAO,EAAO,CAAC;AAC1C,eAAO,IAAI,aAAa,SAAQ,CAAC;AAiDjC,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY7D;AAGD,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB3E"}

package/dist/utils.js

@@ -0,0 +1,104 @@
+// Cache implementation
+export const cache = new Map();
+export const CACHE_TTL = Infinity; // Never expire during session
+export function getCached(key) {
+    const cached = cache.get(key);
+    if (!cached)
+        return null;
+    if (Date.now() - cached.timestamp > CACHE_TTL) {
+        cache.delete(key);
+        return null;
+    }
+    return cached.content;
+}
+export function setCache(key, content) {
+    cache.set(key, { content, timestamp: Date.now() });
+}
+export const BASE_URL = 'https://raw.githubusercontent.com/VKneider/slicejs_docs/master/';
+export const API_BASE = 'https://api.github.com/repos/VKneider/slicejs_docs/contents/';
+// Global structure, populated dynamically
+export let DOCS_STRUCTURE = [];
+export let isInitialized = false;
+// Function to fetch GitHub API for directory contents
+async function fetchGitHubContents(path) {
+    const url = `${API_BASE}${path}`;
+    const response = await fetch(url);
+    if (!response.ok)
+        throw new Error(`GitHub API error: ${response.status}`);
+    return response.json();
+}
+// Recursive function to build DOCS_STRUCTURE
+async function buildDocsStructure(dirPath, basePath = 'markdown') {
+    const items = [];
+    const contents = await fetchGitHubContents(dirPath);
+    for (const item of contents) {
+        if (item.type === 'file' && item.name.endsWith('.md') && item.name !== 'markdown-guide.md') {
+            // Fetch title from content
+            const rawUrl = `https://raw.githubusercontent.com/VKneider/slicejs_docs/master/${item.path}`;
+            let title = item.name.replace('.md', ''); // fallback
+            try {
+                const contentResponse = await fetch(rawUrl);
+                if (contentResponse.ok) {
+                    const content = await contentResponse.text();
+                    const titleMatch = content.split('\n').find(line => line.startsWith('# '));
+                    if (titleMatch)
+                        title = titleMatch.replace('# ', '');
+                }
+            }
+            catch (error) {
+                console.warn(`Failed to fetch title for ${item.path}:`, error);
+            }
+            const relativePath = item.path.replace(`${basePath}/`, '');
+            const id = relativePath.replace(/\.md$/, '').replace(/\//g, '/');
+            items.push({
+                id,
+                path: item.path,
+                title,
+            });
+        }
+        else if (item.type === 'dir') {
+            // Recurse into subdirs
+            const subItems = await buildDocsStructure(item.path, basePath);
+            items.push(...subItems);
+        }
+    }
+    return items;
+}
+// Initialize docs structure dynamically
+export async function initializeDocsStructure() {
+    if (isInitialized)
+        return;
+    try {
+        DOCS_STRUCTURE = await buildDocsStructure('markdown');
+        isInitialized = true;
+        console.log(`Initialized docs structure with ${DOCS_STRUCTURE.length} documents`);
+    }
+    catch (error) {
+        console.error('Failed to initialize docs structure:', error);
+        // Fallback to empty or hardcoded minimal
+        DOCS_STRUCTURE = [];
+    }
+}
+// Helper function to fetch doc content from GitHub
+export async function fetchDocContent(docId) {
+    const cached = getCached(docId);
+    if (cached)
+        return cached;
+    const doc = DOCS_STRUCTURE.find(d => d.id === docId);
+    if (!doc)
+        return null;
+    const url = `${BASE_URL}${doc.path}`;
+    try {
+        const response = await fetch(url);
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status}`);
+        const content = await response.text();
+        setCache(docId, content);
+        return content;
+    }
+    catch (error) {
+        console.error(`Error fetching ${url}:`, error);
+        return null;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "slicejs-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Slicejs documentation access",
+  "license": "MIT",
+  "author": "",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "slicejs-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "fastmcp": "^3.32.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "slicejs",
+    "slice.js",
+    "documentation",
+    "slicejs-web-framework",
+    "llm"
+  ]
+}