junobuild-mcp-server 1.0.1 → 1.0.2

package/dist/index.js

@@ -9,9 +9,10 @@ import { registerFunctionsTools } from "./tools/functions.js";
 import { registerSnapshotTools } from "./tools/snapshot.js";
 import { registerModuleTools } from "./tools/modules.js";
 import { registerChangesTools } from "./tools/changes.js";
+import { registerDocsTools } from "./tools/docs.js";
 const server = new McpServer({
     name: "junobuild-mcp-server",
-    version: "1.0.0"
+    version: "1.0.2",
 });
 registerIdentityTools(server);
 registerConfigTools(server);
@@ -21,6 +22,7 @@ registerFunctionsTools(server);
 registerSnapshotTools(server);
 registerModuleTools(server);
 registerChangesTools(server);
+registerDocsTools(server);
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAE7B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/docs.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+export declare const TOPICS: {
+    readonly intro: "/docs/intro.md";
+    readonly "start-a-new-project": "/docs/start-a-new-project.md";
+    readonly "setup-the-sdk": "/docs/setup-the-sdk.md";
+    readonly "create-a-satellite": "/docs/create-a-satellite.md";
+    readonly authentication: "/docs/build/authentication.md";
+    readonly datastore: "/docs/build/datastore.md";
+    readonly storage: "/docs/build/storage.md";
+    readonly hosting: "/docs/build/hosting.md";
+    readonly functions: "/docs/build/functions.md";
+    readonly analytics: "/docs/build/analytics.md";
+    readonly cli: "/docs/reference/cli.md";
+    readonly configuration: "/docs/reference/configuration.md";
+    readonly plugins: "/docs/reference/plugins.md";
+    readonly settings: "/docs/reference/settings.md";
+    readonly emulator: "/docs/reference/emulator.md";
+    readonly terminology: "/docs/terminology.md";
+    readonly pricing: "/docs/pricing.md";
+};
+export type TopicKey = keyof typeof TOPICS;
+export declare const junoDocsSchema: z.ZodObject<{
+    topic: z.ZodEnum<{
+        hosting: "hosting";
+        emulator: "emulator";
+        functions: "functions";
+        intro: "intro";
+        "start-a-new-project": "start-a-new-project";
+        "setup-the-sdk": "setup-the-sdk";
+        "create-a-satellite": "create-a-satellite";
+        authentication: "authentication";
+        datastore: "datastore";
+        storage: "storage";
+        analytics: "analytics";
+        cli: "cli";
+        configuration: "configuration";
+        plugins: "plugins";
+        settings: "settings";
+        terminology: "terminology";
+        pricing: "pricing";
+    }>;
+}, z.core.$strict>;
+//# sourceMappingURL=docs.d.ts.map

package/dist/schemas/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/schemas/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;CAkBT,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,MAAM,CAAC;AAE3C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;kBAGhB,CAAC"}

package/dist/schemas/docs.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export const TOPICS = {
+    "intro": "/docs/intro.md",
+    "start-a-new-project": "/docs/start-a-new-project.md",
+    "setup-the-sdk": "/docs/setup-the-sdk.md",
+    "create-a-satellite": "/docs/create-a-satellite.md",
+    "authentication": "/docs/build/authentication.md",
+    "datastore": "/docs/build/datastore.md",
+    "storage": "/docs/build/storage.md",
+    "hosting": "/docs/build/hosting.md",
+    "functions": "/docs/build/functions.md",
+    "analytics": "/docs/build/analytics.md",
+    "cli": "/docs/reference/cli.md",
+    "configuration": "/docs/reference/configuration.md",
+    "plugins": "/docs/reference/plugins.md",
+    "settings": "/docs/reference/settings.md",
+    "emulator": "/docs/reference/emulator.md",
+    "terminology": "/docs/terminology.md",
+    "pricing": "/docs/pricing.md"
+};
+export const junoDocsSchema = z.object({
+    topic: z.enum(Object.keys(TOPICS))
+        .describe("Documentation topic to retrieve. Covers Juno concepts, SDK setup, CLI reference, configuration, and more.")
+}).strict();
+//# sourceMappingURL=docs.js.map

package/dist/schemas/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/schemas/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,gBAAgB;IACzB,qBAAqB,EAAE,8BAA8B;IACrD,eAAe,EAAE,wBAAwB;IACzC,oBAAoB,EAAE,6BAA6B;IACnD,gBAAgB,EAAE,+BAA+B;IACjD,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,WAAW,EAAE,0BAA0B;IACvC,WAAW,EAAE,0BAA0B;IACvC,KAAK,EAAE,wBAAwB;IAC/B,eAAe,EAAE,kCAAkC;IACnD,SAAS,EAAE,4BAA4B;IACvC,UAAU,EAAE,6BAA6B;IACzC,UAAU,EAAE,6BAA6B;IACzC,aAAa,EAAE,sBAAsB;IACrC,SAAS,EAAE,kBAAkB;CACrB,CAAC;AAIX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAA8B,CAAC;SAC5D,QAAQ,CAAC,2GAA2G,CAAC;CACzH,CAAC,CAAC,MAAM,EAAE,CAAC"}

package/dist/tools/docs.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDocsTools(server: McpServer): void;
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqDzD"}

package/dist/tools/docs.js

@@ -0,0 +1,52 @@
+import { junoDocsSchema, TOPICS } from "../schemas/docs.js";
+import { CHARACTER_LIMIT } from "../constants.js";
+const BASE_URL = "https://juno.build";
+export function registerDocsTools(server) {
+    server.registerTool("juno_docs", {
+        title: "Juno Documentation",
+        description: "Fetch Juno documentation from juno.build. Provides detailed guides on authentication, datastore, storage, hosting, serverless functions, CLI usage, configuration, and more. Use this to learn how Juno works before running CLI commands.",
+        inputSchema: junoDocsSchema.shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true
+        }
+    }, async (params) => {
+        const path = TOPICS[params.topic];
+        const url = `${BASE_URL}${path}`;
+        try {
+            const response = await fetch(url);
+            if (!response.ok) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Failed to fetch documentation for "${params.topic}" from ${url} (HTTP ${response.status})`
+                        }],
+                    isError: true
+                };
+            }
+            let text = await response.text();
+            if (text.length > CHARACTER_LIMIT) {
+                text = text.slice(0, CHARACTER_LIMIT) + "\n...(truncated)";
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `# Juno Docs: ${params.topic}\n\n${text}`
+                    }]
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Failed to fetch documentation: ${message}`
+                    }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=docs.js.map

package/dist/tools/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAEtC,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,4OAA4O;QACzP,WAAW,EAAE,cAAc,CAAC,KAAK;QACjC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAiB,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,sCAAsC,MAAM,CAAC,KAAK,UAAU,GAAG,UAAU,QAAQ,CAAC,MAAM,GAAG;yBAClG,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;gBAClC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,GAAG,kBAAkB,CAAC;YAC7D,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,gBAAgB,MAAM,CAAC,KAAK,OAAO,IAAI,EAAE;qBAChD,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,kCAAkC,OAAO,EAAE;qBAClD,CAAC;gBACF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "junobuild-mcp-server",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "MCP server for Juno (junobuild) - manage satellites, hosting, functions, snapshots and more",
   "license": "MIT",
   "type": "module",