@farming-labs/docs 0.2.32 → 0.2.33

package/dist/cli/index.mjs

@@ -62,7 +62,13 @@ async function main() {
 		apiRouteRoot: typeof flags["api-route-root"] === "string" ? flags["api-route-root"] : void 0,
 		cloud: typeof flags.cloud === "boolean" ? flags.cloud : void 0
 	};
-	const mcpOptions = { configPath: typeof flags.config === "string" ? flags.config : void 0 };
+	const mcpOptions = {
+		configPath: typeof flags.config === "string" ? flags.config : void 0,
+		setup: subcommand === "setup",
+		deploymentId: typeof flags.deployment === "string" ? flags.deployment : void 0,
+		apiBaseUrl: typeof flags["api-base-url"] === "string" ? flags["api-base-url"] : typeof flags.url === "string" ? flags.url : void 0,
+		json: typeof flags.json === "boolean" ? flags.json : void 0
+	};
 	const devOptions = {
 		verbose: typeof flags.verbose === "boolean" ? flags.verbose : void 0,
 		port: typeof flags.port === "string" ? flags.port : void 0,
@@ -132,7 +138,7 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-HtLVW_s5.mjs");
+		const { runMcp } = await import("../mcp-DaKlH38e.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
 		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-BaiQvHO9.mjs");
@@ -298,6 +304,9 @@ ${pc.dim("Options for init:")}
 
 ${pc.dim("Options for mcp:")}
   ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
+  ${pc.cyan("mcp setup --deployment <id>")} Print Docs Cloud hosted MCP setup for a deployment id
+  ${pc.cyan("--api-base-url <url>")} Override the hosted Docs Cloud API base URL for ${pc.cyan("mcp setup")}
+  ${pc.cyan("--json")}              Print MCP client JSON only for ${pc.cyan("mcp setup")}
 
 ${pc.dim("Options for dev:")}
   ${pc.cyan("--port <number>")}     Run the frameworkless preview on a custom port

package/dist/{mcp-HtLVW_s5.mjs → mcp-DaKlH38e.mjs}

@@ -5,9 +5,14 @@ import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio }
 import "./server.mjs";
 import { c as readNavTitle, m as resolveDocsContentDir, n as extractObjectLiteral, o as readBooleanProperty, p as resolveDocsConfigPath, u as readStringProperty } from "./config-De5z-2LK.mjs";
 import { readFileSync } from "node:fs";
+import pc from "picocolors";
 
 //#region src/cli/mcp.ts
 async function runMcp(options = {}) {
+	if (options.setup) {
+		printHostedMcpSetup(options);
+		return;
+	}
 	const rootDir = process.cwd();
 	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
 	const entry = readStringProperty(content, "entry") ?? "docs";
@@ -25,6 +30,49 @@ async function runMcp(options = {}) {
 		defaultName: navTitle ?? "@farming-labs/docs"
 	});
 }
+function normalizeApiBaseUrl(value) {
+	return (value?.trim() || "https://api.farming-labs.dev").replace(/\/+$/g, "");
+}
+function printHostedMcpSetup(options) {
+	const deploymentId = options.deploymentId?.trim();
+	if (!deploymentId) {
+		console.error(pc.red("Missing MCP deployment id."));
+		console.error();
+		console.error(`Run ${pc.cyan("npx @farming-labs/docs mcp setup --deployment <deployment-id>")}.`);
+		process.exit(1);
+	}
+	const endpoint = `${normalizeApiBaseUrl(options.apiBaseUrl)}/v1/mcp/${deploymentId}`;
+	const jsonConfig = { mcpServers: { "docs-cloud": {
+		command: "npx",
+		args: [
+			"@farming-labs/docs",
+			"mcp",
+			"setup",
+			"--deployment",
+			deploymentId
+		]
+	} } };
+	if (options.json) {
+		console.log(JSON.stringify(jsonConfig, null, 2));
+		return;
+	}
+	console.log(pc.bold("Docs Cloud MCP deployment"));
+	console.log(pc.dim(`Deployment: ${deploymentId}`));
+	console.log();
+	console.log(pc.cyan("CLI stdio"));
+	console.log(`  npx @farming-labs/docs mcp setup --deployment ${deploymentId}`);
+	console.log();
+	console.log(pc.cyan("Streamable HTTP"));
+	console.log(`  ${endpoint}`);
+	console.log();
+	console.log(pc.cyan("SSE"));
+	console.log(`  ${endpoint}/sse`);
+	console.log();
+	console.log(pc.cyan("MCP client JSON"));
+	console.log(JSON.stringify(jsonConfig, null, 2));
+	console.log();
+	console.log(pc.dim("Set DOCS_CLOUD_API_KEY in the agent environment before connecting."));
+}
 function readMcpConfig(content) {
 	if (content.match(/mcp\s*:\s*false/)) return false;
 	if (content.match(/mcp\s*:\s*true/)) return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",