@farming-labs/docs 0.1.1 → 0.1.3

package/dist/mcp-aXyV1jPp.mjs

@@ -0,0 +1,46 @@
+import "./api-reference-DlfH-Y9c.mjs";
+import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
+import "./server.mjs";
+import { a as readStringProperty, i as readNavTitle, o as resolveDocsConfigPath, r as readBooleanProperty, s as resolveDocsContentDir, t as extractObjectLiteral } from "./config-CSywk3ou.mjs";
+import { readFileSync } from "node:fs";
+
+//#region src/cli/mcp.ts
+async function runMcp(options = {}) {
+	const rootDir = process.cwd();
+	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
+	const entry = readStringProperty(content, "entry") ?? "docs";
+	const contentDir = resolveDocsContentDir(rootDir, content, entry);
+	const navTitle = readNavTitle(content);
+	const mcp = readMcpConfig(content);
+	await runDocsMcpStdio({
+		source: createFilesystemDocsMcpSource({
+			rootDir,
+			entry,
+			contentDir,
+			siteTitle: navTitle ?? "Documentation"
+		}),
+		mcp: resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" }),
+		defaultName: navTitle ?? "@farming-labs/docs"
+	});
+}
+function readMcpConfig(content) {
+	if (content.match(/mcp\s*:\s*false/)) return false;
+	if (content.match(/mcp\s*:\s*true/)) return true;
+	const block = extractObjectLiteral(content, "mcp");
+	if (!block) return void 0;
+	return {
+		enabled: readBooleanProperty(block, "enabled"),
+		route: readStringProperty(block, "route"),
+		name: readStringProperty(block, "name"),
+		version: readStringProperty(block, "version"),
+		tools: {
+			listPages: readBooleanProperty(block, "listPages"),
+			readPage: readBooleanProperty(block, "readPage"),
+			searchDocs: readBooleanProperty(block, "searchDocs"),
+			getNavigation: readBooleanProperty(block, "getNavigation")
+		}
+	};
+}
+
+//#endregion
+export { runMcp };

package/dist/mcp.d.mts

@@ -1,5 +1,5 @@
-import { u as DocsMcpConfig, w as OrderingItem } from "./types-Bd3kyFF1.mjs";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
+import { R as OrderingItem, b as DocsSearchConfig, f as DocsMcpConfig } from "./types-BAulrjlV.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
 interface DocsMcpPage {
@@ -62,6 +62,7 @@ interface DocsMcpHttpHandlers {
 interface CreateDocsMcpServerOptions {
   source: DocsMcpSource;
   mcp?: boolean | DocsMcpConfig;
+  search?: boolean | DocsSearchConfig;
   defaultName?: string;
   defaultVersion?: string;
 }

package/dist/mcp.mjs

@@ -1,11 +1,12 @@
+import { s as performDocsSearch } from "./search-BS6C5N1i.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { randomUUID } from "node:crypto";
 import matter from "gray-matter";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp";
-import { isInitializeRequest } from "@modelcontextprotocol/sdk/types";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
 import * as z from "zod/v4";
 
 //#region src/mcp.ts
@@ -88,6 +89,7 @@ async function createDocsMcpServer(options) {
 		defaultName: options.defaultName ?? options.source.siteTitle ?? DEFAULT_MCP_NAME,
 		defaultVersion: options.defaultVersion
 	});
+	const toolSearchConfig = resolveMcpToolSearchConfig(options.search, resolved.route);
 	const server = new McpServer({
 		name: resolved.name,
 		version: resolved.version
@@ -144,7 +146,14 @@ async function createDocsMcpServer(options) {
 		inputSchema: searchDocsInputSchema,
 		annotations: { readOnlyHint: true }
 	}, async ({ query, limit, locale }) => {
-		const results = searchDocsPages(dedupePages(await options.source.getPages(locale)), query, limit ?? 10);
+		const results = await performDocsSearch({
+			pages: toSearchSourcePages(dedupePages(await options.source.getPages(locale))),
+			query,
+			search: toolSearchConfig ?? true,
+			locale,
+			siteTitle: options.source.siteTitle,
+			limit: limit ?? 10
+		});
 		return { content: [{
 			type: "text",
 			text: JSON.stringify({ results }, null, 2)
@@ -382,6 +391,31 @@ function dedupePages(pages) {
 	for (const page of pages) seen.set(page.url, page);
 	return [...seen.values()];
 }
+function toSearchSourcePages(pages) {
+	return pages.map((page) => ({
+		title: page.title,
+		url: page.url,
+		content: page.content,
+		rawContent: page.rawContent,
+		description: page.description
+	}));
+}
+function isSelfMcpSearchEndpoint(search, route) {
+	if (!search || search === true || typeof search !== "object" || search.provider !== "mcp") return false;
+	const endpoint = search.endpoint.trim();
+	if (!endpoint.startsWith("/")) return false;
+	return normalizeDocsMcpRoute(endpoint) === normalizeDocsMcpRoute(route);
+}
+function resolveMcpToolSearchConfig(search, route) {
+	if (!isSelfMcpSearchEndpoint(search, route)) return search;
+	const config = search;
+	return {
+		provider: "simple",
+		enabled: config.enabled,
+		maxResults: config.maxResults,
+		chunking: config.chunking
+	};
+}
 function toPageSummaries(pages) {
 	return pages.map((page) => ({
 		slug: page.slug,
@@ -418,38 +452,6 @@ function normalizeUrlPath(value) {
 	if (normalized === "/") return normalized;
 	return normalized.replace(/\/+$/, "");
 }
-function searchDocsPages(pages, query, limit) {
-	const normalizedQuery = query.toLowerCase().trim();
-	if (!normalizedQuery) return [];
-	const words = normalizedQuery.split(/\s+/).filter(Boolean);
-	return pages.map((page) => {
-		const titleScore = page.title.toLowerCase().includes(normalizedQuery) ? 10 : 0;
-		const descriptionScore = page.description?.toLowerCase().includes(normalizedQuery) ? 4 : 0;
-		const contentScore = words.reduce((score, word) => {
-			return score + (page.content.toLowerCase().includes(word) ? 1 : 0);
-		}, 0);
-		return {
-			slug: page.slug,
-			url: page.url,
-			title: page.title,
-			description: page.description,
-			icon: page.icon,
-			excerpt: buildExcerpt(page, words),
-			score: titleScore + descriptionScore + contentScore
-		};
-	}).filter((page) => page.score > 0).sort((left, right) => right.score - left.score).slice(0, limit).map(({ score: _score, ...page }) => page);
-}
-function buildExcerpt(page, words) {
-	const haystack = page.rawContent ?? page.content;
-	const lower = haystack.toLowerCase();
-	const firstHit = words.find((word) => lower.includes(word.toLowerCase()));
-	if (!firstHit) return page.description;
-	const index = lower.indexOf(firstHit.toLowerCase());
-	const start = Math.max(0, index - 80);
-	const end = Math.min(haystack.length, index + 140);
-	const excerpt = haystack.slice(start, end).replace(/\s+/g, " ").trim();
-	return excerpt.length > 0 ? excerpt : page.description;
-}
 function renderPageDocument(page) {
 	const lines = [`# ${page.title}`, `URL: ${page.url}`];
 	if (page.description) lines.push(`Description: ${page.description}`);