@mantine/mcp-server 9.6.2 → 9.7.0

package/esm/server.mjs

@@ -1,243 +1,22 @@
 "use client";
 import { MantineMcpDataClient } from "./data-client.mjs";
-import readline from "node:readline";
+import { registerTools } from "./tools.mjs";
+import { McpServer } from "@modelcontextprotocol/server";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
 //#region packages/@mantine/mcp-server/src/server.ts
-const TOOL_DEFINITIONS = [
-	{
-		name: "list_items",
-		description: "List Mantine documentation items. Supports filtering by kind (component|hook), package and text query.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				kind: {
-					type: "string",
-					enum: ["component", "hook"]
-				},
-				package: { type: "string" },
-				query: { type: "string" },
-				limit: { type: "number" }
-			},
-			additionalProperties: false
-		}
-	},
-	{
-		name: "get_item_doc",
-		description: "Get the LLM-ready markdown documentation for a Mantine item by name or id.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				name: { type: "string" },
-				kind: {
-					type: "string",
-					enum: ["component", "hook"]
-				}
-			},
-			required: ["name"],
-			additionalProperties: false
-		}
-	},
-	{
-		name: "get_item_props",
-		description: "Get normalized props metadata for a Mantine item by name or id.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				name: { type: "string" },
-				kind: {
-					type: "string",
-					enum: ["component", "hook"]
-				}
-			},
-			required: ["name"],
-			additionalProperties: false
-		}
-	},
-	{
-		name: "search_docs",
-		description: "Search Mantine docs by free text query and return ranked matches.",
-		inputSchema: {
-			type: "object",
-			properties: {
-				kind: {
-					type: "string",
-					enum: ["component", "hook"]
-				},
-				query: { type: "string" },
-				limit: { type: "number" }
-			},
-			required: ["query"],
-			additionalProperties: false
-		}
-	}
-];
-function createJsonRpcError(code, message) {
-	return {
-		code,
-		message
-	};
-}
-function toToolResult(content) {
-	return { content: [{
-		type: "text",
-		text: typeof content === "string" ? content : JSON.stringify(content, null, 2)
-	}] };
-}
-function toToolError(message) {
-	return {
-		isError: true,
-		content: [{
-			type: "text",
-			text: message
-		}]
-	};
-}
-function parseListItemsArgs(args) {
-	return {
-		kind: args.kind === "component" || args.kind === "hook" ? args.kind : void 0,
-		package: typeof args.package === "string" ? args.package : void 0,
-		query: typeof args.query === "string" ? args.query : void 0,
-		limit: typeof args.limit === "number" ? args.limit : void 0
-	};
-}
-function parseGetItemArgs(args) {
-	if (typeof args.name !== "string" || args.name.length === 0) return null;
-	return {
-		name: args.name,
-		kind: args.kind === "component" || args.kind === "hook" ? args.kind : void 0
-	};
-}
-function parseSearchDocsArgs(args) {
-	if (typeof args.query !== "string" || args.query.length === 0) return null;
-	return {
-		query: args.query,
-		kind: args.kind === "component" || args.kind === "hook" ? args.kind : void 0,
-		limit: typeof args.limit === "number" ? args.limit : void 0
-	};
-}
-function writeMessage(payload) {
-	process.stdout.write(`${JSON.stringify(payload)}\n`);
-}
-function writeResponse(id, result) {
-	writeMessage({
-		jsonrpc: "2.0",
-		id,
-		result
-	});
-}
-function writeError(id, code, message) {
-	writeMessage({
-		jsonrpc: "2.0",
-		id,
-		error: createJsonRpcError(code, message)
-	});
-}
+/** Starts the Mantine documentation MCP server over stdio */
 function startServer() {
 	const timeoutMs = Number(process.env.MANTINE_MCP_TIMEOUT_MS || 1e4);
 	const dataUrl = process.env.MANTINE_MCP_DATA_URL || "https://mantine.dev/mcp";
-	const client = new MantineMcpDataClient(dataUrl, timeoutMs);
-	readline.createInterface({
-		input: process.stdin,
-		terminal: false
-	}).on("line", (line) => {
-		const trimmed = line.trim();
-		if (trimmed.length === 0) return;
-		let request;
-		try {
-			request = JSON.parse(trimmed);
-		} catch {
-			writeError(null, -32700, "Parse error");
-			return;
-		}
-		handleRequest(client, request);
+	serveStdio(() => {
+		const server = new McpServer({
+			name: "@mantine/mcp-server",
+			version: "9"
+		});
+		registerTools(server, new MantineMcpDataClient(dataUrl, timeoutMs));
+		return server;
 	});
 }
-async function handleRequest(client, request) {
-	const id = request.id ?? null;
-	if (!request || request.jsonrpc !== "2.0" || typeof request.method !== "string") {
-		writeError(id, -32600, "Invalid request");
-		return;
-	}
-	try {
-		switch (request.method) {
-			case "initialize":
-				writeResponse(id, {
-					protocolVersion: "2024-11-05",
-					capabilities: { tools: {} },
-					serverInfo: {
-						name: "@mantine/mcp-server",
-						version: "9"
-					}
-				});
-				break;
-			case "notifications/initialized": return;
-			case "tools/list":
-				writeResponse(id, { tools: TOOL_DEFINITIONS });
-				return;
-			case "tools/call": {
-				const params = request.params && typeof request.params === "object" ? request.params : {};
-				const name = typeof params.name === "string" ? params.name : "";
-				const args = params.arguments && typeof params.arguments === "object" ? params.arguments : {};
-				if (!name) {
-					writeResponse(id, toToolError("Tool name is required"));
-					return;
-				}
-				if (name === "list_items") {
-					writeResponse(id, toToolResult(await client.listItems(parseListItemsArgs(args))));
-					return;
-				}
-				if (name === "get_item_doc") {
-					const parsed = parseGetItemArgs(args);
-					if (!parsed) {
-						writeResponse(id, toToolError("Argument \"name\" is required"));
-						return;
-					}
-					const result = await client.getItemDoc(parsed);
-					if (!result) {
-						writeResponse(id, toToolError(`Item not found: ${parsed.name}`));
-						return;
-					}
-					writeResponse(id, toToolResult(result));
-					return;
-				}
-				if (name === "get_item_props") {
-					const parsed = parseGetItemArgs(args);
-					if (!parsed) {
-						writeResponse(id, toToolError("Argument \"name\" is required"));
-						return;
-					}
-					const result = await client.getItemProps(parsed);
-					if (!result) {
-						writeResponse(id, toToolError(`Item not found: ${parsed.name}`));
-						return;
-					}
-					writeResponse(id, toToolResult(result));
-					return;
-				}
-				if (name === "search_docs") {
-					const parsed = parseSearchDocsArgs(args);
-					if (!parsed) {
-						writeResponse(id, toToolError("Argument \"query\" is required"));
-						return;
-					}
-					writeResponse(id, toToolResult(await client.searchDocs(parsed)));
-					return;
-				}
-				writeResponse(id, toToolError(`Unknown tool: ${name}`));
-				return;
-			}
-			default:
-				if (id === null) return;
-				writeError(id, -32601, `Method not found: ${request.method}`);
-		}
-	} catch (error) {
-		const message = error instanceof Error ? error.message : "Unexpected error";
-		if (request.method === "tools/call") {
-			writeResponse(id, toToolError(message));
-			return;
-		}
-		writeError(id, -32e3, message);
-	}
-}
 //#endregion
 export { startServer };
 

package/esm/server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["import readline from 'node:readline';\nimport { MantineMcpDataClient } from './data-client';\nimport { GetItemArgs, ListItemsArgs, SearchDocsArgs } from './types';\n\ninterface JsonRpcRequest {\n  jsonrpc: '2.0';\n  id?: string | number | null;\n  method: string;\n  params?: unknown;\n}\n\nconst TOOL_DEFINITIONS = [\n  {\n    name: 'list_items',\n    description:\n      'List Mantine documentation items. Supports filtering by kind (component|hook), package and text query.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        kind: { type: 'string', enum: ['component', 'hook'] },\n        package: { type: 'string' },\n        query: { type: 'string' },\n        limit: { type: 'number' },\n      },\n      additionalProperties: false,\n    },\n  },\n  {\n    name: 'get_item_doc',\n    description: 'Get the LLM-ready markdown documentation for a Mantine item by name or id.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        name: { type: 'string' },\n        kind: { type: 'string', enum: ['component', 'hook'] },\n      },\n      required: ['name'],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: 'get_item_props',\n    description: 'Get normalized props metadata for a Mantine item by name or id.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        name: { type: 'string' },\n        kind: { type: 'string', enum: ['component', 'hook'] },\n      },\n      required: ['name'],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: 'search_docs',\n    description: 'Search Mantine docs by free text query and return ranked matches.',\n    inputSchema: {\n      type: 'object',\n      properties: {\n        kind: { type: 'string', enum: ['component', 'hook'] },\n        query: { type: 'string' },\n        limit: { type: 'number' },\n      },\n      required: ['query'],\n      additionalProperties: false,\n    },\n  },\n];\n\nfunction createJsonRpcError(code: number, message: string) {\n  return { code, message };\n}\n\nfunction toToolResult(content: unknown) {\n  const text = typeof content === 'string' ? content : JSON.stringify(content, null, 2);\n\n  return {\n    content: [{ type: 'text', text }],\n  };\n}\n\nfunction toToolError(message: string) {\n  return {\n    isError: true,\n    content: [{ type: 'text', text: message }],\n  };\n}\n\nfunction parseListItemsArgs(args: Record<string, unknown>): ListItemsArgs {\n  return {\n    kind: args.kind === 'component' || args.kind === 'hook' ? args.kind : undefined,\n    package: typeof args.package === 'string' ? args.package : undefined,\n    query: typeof args.query === 'string' ? args.query : undefined,\n    limit: typeof args.limit === 'number' ? args.limit : undefined,\n  };\n}\n\nfunction parseGetItemArgs(args: Record<string, unknown>): GetItemArgs | null {\n  if (typeof args.name !== 'string' || args.name.length === 0) {\n    return null;\n  }\n\n  return {\n    name: args.name,\n    kind: args.kind === 'component' || args.kind === 'hook' ? args.kind : undefined,\n  };\n}\n\nfunction parseSearchDocsArgs(args: Record<string, unknown>): SearchDocsArgs | null {\n  if (typeof args.query !== 'string' || args.query.length === 0) {\n    return null;\n  }\n\n  return {\n    query: args.query,\n    kind: args.kind === 'component' || args.kind === 'hook' ? args.kind : undefined,\n    limit: typeof args.limit === 'number' ? args.limit : undefined,\n  };\n}\n\nfunction writeMessage(payload: unknown) {\n  process.stdout.write(`${JSON.stringify(payload)}\\n`);\n}\n\nfunction writeResponse(id: string | number | null, result: unknown) {\n  writeMessage({ jsonrpc: '2.0', id, result });\n}\n\nfunction writeError(id: string | number | null, code: number, message: string) {\n  writeMessage({\n    jsonrpc: '2.0',\n    id,\n    error: createJsonRpcError(code, message),\n  });\n}\n\nexport function startServer() {\n  const timeoutMs = Number(process.env.MANTINE_MCP_TIMEOUT_MS || 10000);\n  const dataUrl = process.env.MANTINE_MCP_DATA_URL || 'https://mantine.dev/mcp';\n  const client = new MantineMcpDataClient(dataUrl, timeoutMs);\n\n  const rl = readline.createInterface({ input: process.stdin, terminal: false });\n\n  rl.on('line', (line: string) => {\n    const trimmed = line.trim();\n    if (trimmed.length === 0) {\n      return;\n    }\n\n    let request: JsonRpcRequest;\n    try {\n      request = JSON.parse(trimmed);\n    } catch {\n      writeError(null, -32700, 'Parse error');\n      return;\n    }\n\n    void handleRequest(client, request);\n  });\n}\n\nasync function handleRequest(client: MantineMcpDataClient, request: JsonRpcRequest) {\n  const id = request.id ?? null;\n\n  if (!request || request.jsonrpc !== '2.0' || typeof request.method !== 'string') {\n    writeError(id, -32600, 'Invalid request');\n    return;\n  }\n\n  try {\n    switch (request.method) {\n      case 'initialize': {\n        writeResponse(id, {\n          protocolVersion: '2024-11-05',\n          capabilities: {\n            tools: {},\n          },\n          serverInfo: {\n            name: '@mantine/mcp-server',\n            version: '9',\n          },\n        });\n        break;\n      }\n\n      case 'notifications/initialized': {\n        return;\n      }\n\n      case 'tools/list': {\n        writeResponse(id, { tools: TOOL_DEFINITIONS });\n        return;\n      }\n\n      case 'tools/call': {\n        const params =\n          request.params && typeof request.params === 'object'\n            ? (request.params as Record<string, unknown>)\n            : {};\n        const name = typeof params.name === 'string' ? params.name : '';\n        const args =\n          params.arguments && typeof params.arguments === 'object'\n            ? (params.arguments as Record<string, unknown>)\n            : {};\n\n        if (!name) {\n          writeResponse(id, toToolError('Tool name is required'));\n          return;\n        }\n\n        if (name === 'list_items') {\n          const result = await client.listItems(parseListItemsArgs(args));\n          writeResponse(id, toToolResult(result));\n          return;\n        }\n\n        if (name === 'get_item_doc') {\n          const parsed = parseGetItemArgs(args);\n          if (!parsed) {\n            writeResponse(id, toToolError('Argument \"name\" is required'));\n            return;\n          }\n\n          const result = await client.getItemDoc(parsed);\n          if (!result) {\n            writeResponse(id, toToolError(`Item not found: ${parsed.name}`));\n            return;\n          }\n\n          writeResponse(id, toToolResult(result));\n          return;\n        }\n\n        if (name === 'get_item_props') {\n          const parsed = parseGetItemArgs(args);\n          if (!parsed) {\n            writeResponse(id, toToolError('Argument \"name\" is required'));\n            return;\n          }\n\n          const result = await client.getItemProps(parsed);\n          if (!result) {\n            writeResponse(id, toToolError(`Item not found: ${parsed.name}`));\n            return;\n          }\n\n          writeResponse(id, toToolResult(result));\n          return;\n        }\n\n        if (name === 'search_docs') {\n          const parsed = parseSearchDocsArgs(args);\n          if (!parsed) {\n            writeResponse(id, toToolError('Argument \"query\" is required'));\n            return;\n          }\n\n          const result = await client.searchDocs(parsed);\n          writeResponse(id, toToolResult(result));\n          return;\n        }\n\n        writeResponse(id, toToolError(`Unknown tool: ${name}`));\n        return;\n      }\n\n      default: {\n        if (id === null) {\n          return;\n        }\n\n        writeError(id, -32601, `Method not found: ${request.method}`);\n      }\n    }\n  } catch (error) {\n    const message = error instanceof Error ? error.message : 'Unexpected error';\n\n    if (request.method === 'tools/call') {\n      writeResponse(id, toToolError(message));\n      return;\n    }\n\n    writeError(id, -32000, message);\n  }\n}\n"],"mappings":";;;;AAWA,MAAM,mBAAmB;CACvB;EACE,MAAM;EACN,aACE;EACF,aAAa;GACX,MAAM;GACN,YAAY;IACV,MAAM;KAAE,MAAM;KAAU,MAAM,CAAC,aAAa,MAAM;IAAE;IACpD,SAAS,EAAE,MAAM,SAAS;IAC1B,OAAO,EAAE,MAAM,SAAS;IACxB,OAAO,EAAE,MAAM,SAAS;GAC1B;GACA,sBAAsB;EACxB;CACF;CACA;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,YAAY;IACV,MAAM,EAAE,MAAM,SAAS;IACvB,MAAM;KAAE,MAAM;KAAU,MAAM,CAAC,aAAa,MAAM;IAAE;GACtD;GACA,UAAU,CAAC,MAAM;GACjB,sBAAsB;EACxB;CACF;CACA;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,YAAY;IACV,MAAM,EAAE,MAAM,SAAS;IACvB,MAAM;KAAE,MAAM;KAAU,MAAM,CAAC,aAAa,MAAM;IAAE;GACtD;GACA,UAAU,CAAC,MAAM;GACjB,sBAAsB;EACxB;CACF;CACA;EACE,MAAM;EACN,aAAa;EACb,aAAa;GACX,MAAM;GACN,YAAY;IACV,MAAM;KAAE,MAAM;KAAU,MAAM,CAAC,aAAa,MAAM;IAAE;IACpD,OAAO,EAAE,MAAM,SAAS;IACxB,OAAO,EAAE,MAAM,SAAS;GAC1B;GACA,UAAU,CAAC,OAAO;GAClB,sBAAsB;EACxB;CACF;AACF;AAEA,SAAS,mBAAmB,MAAc,SAAiB;CACzD,OAAO;EAAE;EAAM;CAAQ;AACzB;AAEA,SAAS,aAAa,SAAkB;CAGtC,OAAO,EACL,SAAS,CAAC;EAAE,MAAM;EAAQ,MAHf,OAAO,YAAY,WAAW,UAAU,KAAK,UAAU,SAAS,MAAM,CAAC;CAGnD,CAAC,EAClC;AACF;AAEA,SAAS,YAAY,SAAiB;CACpC,OAAO;EACL,SAAS;EACT,SAAS,CAAC;GAAE,MAAM;GAAQ,MAAM;EAAQ,CAAC;CAC3C;AACF;AAEA,SAAS,mBAAmB,MAA8C;CACxE,OAAO;EACL,MAAM,KAAK,SAAS,eAAe,KAAK,SAAS,SAAS,KAAK,OAAO,KAAA;EACtE,SAAS,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU,KAAA;EAC3D,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;EACrD,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;CACvD;AACF;AAEA,SAAS,iBAAiB,MAAmD;CAC3E,IAAI,OAAO,KAAK,SAAS,YAAY,KAAK,KAAK,WAAW,GACxD,OAAO;CAGT,OAAO;EACL,MAAM,KAAK;EACX,MAAM,KAAK,SAAS,eAAe,KAAK,SAAS,SAAS,KAAK,OAAO,KAAA;CACxE;AACF;AAEA,SAAS,oBAAoB,MAAsD;CACjF,IAAI,OAAO,KAAK,UAAU,YAAY,KAAK,MAAM,WAAW,GAC1D,OAAO;CAGT,OAAO;EACL,OAAO,KAAK;EACZ,MAAM,KAAK,SAAS,eAAe,KAAK,SAAS,SAAS,KAAK,OAAO,KAAA;EACtE,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;CACvD;AACF;AAEA,SAAS,aAAa,SAAkB;CACtC,QAAQ,OAAO,MAAM,GAAG,KAAK,UAAU,OAAO,EAAE,GAAG;AACrD;AAEA,SAAS,cAAc,IAA4B,QAAiB;CAClE,aAAa;EAAE,SAAS;EAAO;EAAI;CAAO,CAAC;AAC7C;AAEA,SAAS,WAAW,IAA4B,MAAc,SAAiB;CAC7E,aAAa;EACX,SAAS;EACT;EACA,OAAO,mBAAmB,MAAM,OAAO;CACzC,CAAC;AACH;AAEA,SAAgB,cAAc;CAC5B,MAAM,YAAY,OAAO,QAAQ,IAAI,0BAA0B,GAAK;CACpE,MAAM,UAAU,QAAQ,IAAI,wBAAwB;CACpD,MAAM,SAAS,IAAI,qBAAqB,SAAS,SAAS;CAI1D,SAFoB,gBAAgB;EAAE,OAAO,QAAQ;EAAO,UAAU;CAAM,CAE3E,CAAC,CAAC,GAAG,SAAS,SAAiB;EAC9B,MAAM,UAAU,KAAK,KAAK;EAC1B,IAAI,QAAQ,WAAW,GACrB;EAGF,IAAI;EACJ,IAAI;GACF,UAAU,KAAK,MAAM,OAAO;EAC9B,QAAQ;GACN,WAAW,MAAM,QAAQ,aAAa;GACtC;EACF;EAEA,cAAmB,QAAQ,OAAO;CACpC,CAAC;AACH;AAEA,eAAe,cAAc,QAA8B,SAAyB;CAClF,MAAM,KAAK,QAAQ,MAAM;CAEzB,IAAI,CAAC,WAAW,QAAQ,YAAY,SAAS,OAAO,QAAQ,WAAW,UAAU;EAC/E,WAAW,IAAI,QAAQ,iBAAiB;EACxC;CACF;CAEA,IAAI;EACF,QAAQ,QAAQ,QAAhB;GACE,KAAK;IACH,cAAc,IAAI;KAChB,iBAAiB;KACjB,cAAc,EACZ,OAAO,CAAC,EACV;KACA,YAAY;MACV,MAAM;MACN,SAAS;KACX;IACF,CAAC;IACD;GAGF,KAAK,6BACH;GAGF,KAAK;IACH,cAAc,IAAI,EAAE,OAAO,iBAAiB,CAAC;IAC7C;GAGF,KAAK,cAAc;IACjB,MAAM,SACJ,QAAQ,UAAU,OAAO,QAAQ,WAAW,WACvC,QAAQ,SACT,CAAC;IACP,MAAM,OAAO,OAAO,OAAO,SAAS,WAAW,OAAO,OAAO;IAC7D,MAAM,OACJ,OAAO,aAAa,OAAO,OAAO,cAAc,WAC3C,OAAO,YACR,CAAC;IAEP,IAAI,CAAC,MAAM;KACT,cAAc,IAAI,YAAY,uBAAuB,CAAC;KACtD;IACF;IAEA,IAAI,SAAS,cAAc;KAEzB,cAAc,IAAI,aAAa,MADV,OAAO,UAAU,mBAAmB,IAAI,CAAC,CACzB,CAAC;KACtC;IACF;IAEA,IAAI,SAAS,gBAAgB;KAC3B,MAAM,SAAS,iBAAiB,IAAI;KACpC,IAAI,CAAC,QAAQ;MACX,cAAc,IAAI,YAAY,+BAA6B,CAAC;MAC5D;KACF;KAEA,MAAM,SAAS,MAAM,OAAO,WAAW,MAAM;KAC7C,IAAI,CAAC,QAAQ;MACX,cAAc,IAAI,YAAY,mBAAmB,OAAO,MAAM,CAAC;MAC/D;KACF;KAEA,cAAc,IAAI,aAAa,MAAM,CAAC;KACtC;IACF;IAEA,IAAI,SAAS,kBAAkB;KAC7B,MAAM,SAAS,iBAAiB,IAAI;KACpC,IAAI,CAAC,QAAQ;MACX,cAAc,IAAI,YAAY,+BAA6B,CAAC;MAC5D;KACF;KAEA,MAAM,SAAS,MAAM,OAAO,aAAa,MAAM;KAC/C,IAAI,CAAC,QAAQ;MACX,cAAc,IAAI,YAAY,mBAAmB,OAAO,MAAM,CAAC;MAC/D;KACF;KAEA,cAAc,IAAI,aAAa,MAAM,CAAC;KACtC;IACF;IAEA,IAAI,SAAS,eAAe;KAC1B,MAAM,SAAS,oBAAoB,IAAI;KACvC,IAAI,CAAC,QAAQ;MACX,cAAc,IAAI,YAAY,gCAA8B,CAAC;MAC7D;KACF;KAGA,cAAc,IAAI,aAAa,MADV,OAAO,WAAW,MAAM,CACR,CAAC;KACtC;IACF;IAEA,cAAc,IAAI,YAAY,iBAAiB,MAAM,CAAC;IACtD;GACF;GAEA;IACE,IAAI,OAAO,MACT;IAGF,WAAW,IAAI,QAAQ,qBAAqB,QAAQ,QAAQ;EAEhE;CACF,SAAS,OAAO;EACd,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;EAEzD,IAAI,QAAQ,WAAW,cAAc;GACnC,cAAc,IAAI,YAAY,OAAO,CAAC;GACtC;EACF;EAEA,WAAW,IAAI,OAAQ,OAAO;CAChC;AACF"}
+{"version":3,"file":"server.mjs","names":[],"sources":["../src/server.ts"],"sourcesContent":["import { McpServer } from '@modelcontextprotocol/server';\nimport { serveStdio } from '@modelcontextprotocol/server/stdio';\nimport { MantineMcpDataClient } from './data-client';\nimport { registerTools } from './tools';\n\n/** Starts the Mantine documentation MCP server over stdio */\nexport function startServer(): void {\n  const timeoutMs = Number(process.env.MANTINE_MCP_TIMEOUT_MS || 10000);\n  const dataUrl = process.env.MANTINE_MCP_DATA_URL || 'https://mantine.dev/mcp';\n\n  serveStdio(() => {\n    const server = new McpServer({ name: '@mantine/mcp-server', version: '9' });\n    registerTools(server, new MantineMcpDataClient(dataUrl, timeoutMs));\n    return server;\n  });\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,cAAoB;CAClC,MAAM,YAAY,OAAO,QAAQ,IAAI,0BAA0B,GAAK;CACpE,MAAM,UAAU,QAAQ,IAAI,wBAAwB;CAEpD,iBAAiB;EACf,MAAM,SAAS,IAAI,UAAU;GAAE,MAAM;GAAuB,SAAS;EAAI,CAAC;EAC1E,cAAc,QAAQ,IAAI,qBAAqB,SAAS,SAAS,CAAC;EAClE,OAAO;CACT,CAAC;AACH"}

package/esm/tools.mjs

@@ -0,0 +1,106 @@
+"use client";
+import * as z from "zod";
+//#region packages/@mantine/mcp-server/src/tools.ts
+const kindSchema = z.enum([
+	"component",
+	"hook",
+	"guide",
+	"faq"
+]);
+const groupSchema = z.enum([
+	"gettingStarted",
+	"theming",
+	"hooks",
+	"components",
+	"extensions",
+	"form"
+]);
+const nameSchema = z.string().trim().min(1);
+function text(payload) {
+	return { content: [{
+		type: "text",
+		text: typeof payload === "string" ? payload : JSON.stringify(payload, null, 2)
+	}] };
+}
+function error(message) {
+	return {
+		isError: true,
+		content: [{
+			type: "text",
+			text: message
+		}]
+	};
+}
+/** Registers every Mantine documentation tool on an MCP server instance */
+function registerTools(server, client) {
+	server.registerTool("search_docs", {
+		title: "Search Mantine documentation",
+		description: "Search all Mantine documentation — components, hooks, @mantine/form, styling, theming, guides and FAQ. Returns ranked matches; a match may point at a specific section, which can then be fetched with get_item_doc.",
+		inputSchema: z.object({
+			query: z.string().describe("Free text query, e.g. \"validate a form with zod\""),
+			kind: kindSchema.optional(),
+			package: z.string().optional().describe("Filter by package, e.g. \"@mantine/form\""),
+			limit: z.number().optional().describe("Maximum number of results (default 20, max 100)")
+		})
+	}, async (args) => text(await client.search(args)));
+	server.registerTool("get_item_doc", {
+		title: "Get Mantine documentation",
+		description: "Get documentation for a Mantine component, hook, guide or FAQ page. Without a section it returns an outline (description plus section list) — pass a section to fetch just that part, or full:true for the whole page.",
+		inputSchema: z.object({
+			name: nameSchema.describe("Item name or id, e.g. \"useForm\", \"Button\", \"form-validation\""),
+			kind: kindSchema.optional(),
+			section: z.string().optional().describe("Section slug from the outline, e.g. \"zod\""),
+			full: z.boolean().optional().describe("Return the entire page; can be very large")
+		})
+	}, async (args) => {
+		const result = await client.getDoc(args);
+		if (!result) {
+			const suggestions = await client.suggestFor(args.name);
+			return error(suggestions.length > 0 ? `No exact match for "${args.name}". Did you mean: ${suggestions.join(", ")}?` : `No Mantine documentation found for "${args.name}". Try search_docs first.`);
+		}
+		return text(result);
+	});
+	server.registerTool("get_item_props", {
+		title: "Get Mantine props or signature",
+		description: "Get props for a Mantine component, or the TypeScript signature for a hook. Pages documenting an API in prose point at the relevant section instead.",
+		inputSchema: z.object({
+			name: nameSchema,
+			kind: kindSchema.optional()
+		})
+	}, async (args) => {
+		const result = await client.getProps(args);
+		if (!result) {
+			const suggestions = await client.suggestFor(args.name);
+			return error(suggestions.length > 0 ? `No exact match for "${args.name}". Did you mean: ${suggestions.join(", ")}?` : `No Mantine documentation found for "${args.name}".`);
+		}
+		return text(result);
+	});
+	server.registerTool("list_items", {
+		title: "List Mantine documentation items",
+		description: "List Mantine documentation items, filtered by kind, nav group, category, package or a text query.",
+		inputSchema: z.object({
+			kind: kindSchema.optional(),
+			group: groupSchema.optional(),
+			category: z.string().optional(),
+			package: z.string().optional(),
+			query: z.string().optional(),
+			limit: z.number().optional().describe("Maximum number of results (default 30, max 500)")
+		})
+	}, async (args) => text(await client.listItems(args)));
+	server.registerTool("get_api", {
+		title: "Resolve a Mantine symbol",
+		description: "Resolve a Mantine symbol (useForm, useDisclosure, UseFormReturnType) to its TypeScript signature and exported types, without knowing which page documents it.",
+		inputSchema: z.object({ symbol: nameSchema })
+	}, async ({ symbol }) => {
+		const result = await client.getApi(symbol);
+		if (!result) {
+			const suggestions = await client.suggestFor(symbol);
+			return error(suggestions.length > 0 ? `No API found for "${symbol}". Did you mean: ${suggestions.join(", ")}?` : `No API found for "${symbol}". Try search_docs.`);
+		}
+		return text(result);
+	});
+}
+//#endregion
+export { registerTools };
+
+//# sourceMappingURL=tools.mjs.map

package/esm/tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.mjs","names":[],"sources":["../src/tools.ts"],"sourcesContent":["import type { McpServer } from '@modelcontextprotocol/server';\nimport * as z from 'zod';\nimport { MantineMcpDataClient } from './data-client';\n\nconst kindSchema = z.enum(['component', 'hook', 'guide', 'faq']);\nconst groupSchema = z.enum([\n  'gettingStarted',\n  'theming',\n  'hooks',\n  'components',\n  'extensions',\n  'form',\n]);\nconst nameSchema = z.string().trim().min(1);\n\nfunction text(payload: unknown) {\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: typeof payload === 'string' ? payload : JSON.stringify(payload, null, 2),\n      },\n    ],\n  };\n}\n\nfunction error(message: string) {\n  return { isError: true, content: [{ type: 'text' as const, text: message }] };\n}\n\n/** Registers every Mantine documentation tool on an MCP server instance */\nexport function registerTools(server: McpServer, client: MantineMcpDataClient): void {\n  server.registerTool(\n    'search_docs',\n    {\n      title: 'Search Mantine documentation',\n      description:\n        'Search all Mantine documentation — components, hooks, @mantine/form, styling, theming, guides and FAQ. Returns ranked matches; a match may point at a specific section, which can then be fetched with get_item_doc.',\n      inputSchema: z.object({\n        query: z.string().describe('Free text query, e.g. \"validate a form with zod\"'),\n        kind: kindSchema.optional(),\n        package: z.string().optional().describe('Filter by package, e.g. \"@mantine/form\"'),\n        limit: z.number().optional().describe('Maximum number of results (default 20, max 100)'),\n      }),\n    },\n    async (args) => text(await client.search(args))\n  );\n\n  server.registerTool(\n    'get_item_doc',\n    {\n      title: 'Get Mantine documentation',\n      description:\n        'Get documentation for a Mantine component, hook, guide or FAQ page. Without a section it returns an outline (description plus section list) — pass a section to fetch just that part, or full:true for the whole page.',\n      inputSchema: z.object({\n        name: nameSchema.describe('Item name or id, e.g. \"useForm\", \"Button\", \"form-validation\"'),\n        kind: kindSchema.optional(),\n        section: z.string().optional().describe('Section slug from the outline, e.g. \"zod\"'),\n        full: z.boolean().optional().describe('Return the entire page; can be very large'),\n      }),\n    },\n    async (args) => {\n      const result = await client.getDoc(args);\n\n      if (!result) {\n        const suggestions = await client.suggestFor(args.name);\n        return error(\n          suggestions.length > 0\n            ? `No exact match for \"${args.name}\". Did you mean: ${suggestions.join(', ')}?`\n            : `No Mantine documentation found for \"${args.name}\". Try search_docs first.`\n        );\n      }\n\n      return text(result);\n    }\n  );\n\n  server.registerTool(\n    'get_item_props',\n    {\n      title: 'Get Mantine props or signature',\n      description:\n        'Get props for a Mantine component, or the TypeScript signature for a hook. Pages documenting an API in prose point at the relevant section instead.',\n      inputSchema: z.object({ name: nameSchema, kind: kindSchema.optional() }),\n    },\n    async (args) => {\n      const result = await client.getProps(args);\n\n      if (!result) {\n        const suggestions = await client.suggestFor(args.name);\n        return error(\n          suggestions.length > 0\n            ? `No exact match for \"${args.name}\". Did you mean: ${suggestions.join(', ')}?`\n            : `No Mantine documentation found for \"${args.name}\".`\n        );\n      }\n\n      return text(result);\n    }\n  );\n\n  server.registerTool(\n    'list_items',\n    {\n      title: 'List Mantine documentation items',\n      description:\n        'List Mantine documentation items, filtered by kind, nav group, category, package or a text query.',\n      inputSchema: z.object({\n        kind: kindSchema.optional(),\n        group: groupSchema.optional(),\n        category: z.string().optional(),\n        package: z.string().optional(),\n        query: z.string().optional(),\n        limit: z.number().optional().describe('Maximum number of results (default 30, max 500)'),\n      }),\n    },\n    async (args) => text(await client.listItems(args))\n  );\n\n  server.registerTool(\n    'get_api',\n    {\n      title: 'Resolve a Mantine symbol',\n      description:\n        'Resolve a Mantine symbol (useForm, useDisclosure, UseFormReturnType) to its TypeScript signature and exported types, without knowing which page documents it.',\n      inputSchema: z.object({ symbol: nameSchema }),\n    },\n    async ({ symbol }) => {\n      const result = await client.getApi(symbol);\n\n      if (!result) {\n        const suggestions = await client.suggestFor(symbol);\n        return error(\n          suggestions.length > 0\n            ? `No API found for \"${symbol}\". Did you mean: ${suggestions.join(', ')}?`\n            : `No API found for \"${symbol}\". Try search_docs.`\n        );\n      }\n\n      return text(result);\n    }\n  );\n}\n"],"mappings":";;;AAIA,MAAM,aAAa,EAAE,KAAK;CAAC;CAAa;CAAQ;CAAS;AAAK,CAAC;AAC/D,MAAM,cAAc,EAAE,KAAK;CACzB;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AACD,MAAM,aAAa,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;AAE1C,SAAS,KAAK,SAAkB;CAC9B,OAAO,EACL,SAAS,CACP;EACE,MAAM;EACN,MAAM,OAAO,YAAY,WAAW,UAAU,KAAK,UAAU,SAAS,MAAM,CAAC;CAC/E,CACF,EACF;AACF;AAEA,SAAS,MAAM,SAAiB;CAC9B,OAAO;EAAE,SAAS;EAAM,SAAS,CAAC;GAAE,MAAM;GAAiB,MAAM;EAAQ,CAAC;CAAE;AAC9E;;AAGA,SAAgB,cAAc,QAAmB,QAAoC;CACnF,OAAO,aACL,eACA;EACE,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO;GACpB,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,oDAAkD;GAC7E,MAAM,WAAW,SAAS;GAC1B,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,2CAAyC;GACjF,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,iDAAiD;EACzF,CAAC;CACH,GACA,OAAO,SAAS,KAAK,MAAM,OAAO,OAAO,IAAI,CAAC,CAChD;CAEA,OAAO,aACL,gBACA;EACE,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO;GACpB,MAAM,WAAW,SAAS,oEAA8D;GACxF,MAAM,WAAW,SAAS;GAC1B,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,6CAA2C;GACnF,MAAM,EAAE,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,2CAA2C;EACnF,CAAC;CACH,GACA,OAAO,SAAS;EACd,MAAM,SAAS,MAAM,OAAO,OAAO,IAAI;EAEvC,IAAI,CAAC,QAAQ;GACX,MAAM,cAAc,MAAM,OAAO,WAAW,KAAK,IAAI;GACrD,OAAO,MACL,YAAY,SAAS,IACjB,uBAAuB,KAAK,KAAK,mBAAmB,YAAY,KAAK,IAAI,EAAE,KAC3E,uCAAuC,KAAK,KAAK,0BACvD;EACF;EAEA,OAAO,KAAK,MAAM;CACpB,CACF;CAEA,OAAO,aACL,kBACA;EACE,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO;GAAE,MAAM;GAAY,MAAM,WAAW,SAAS;EAAE,CAAC;CACzE,GACA,OAAO,SAAS;EACd,MAAM,SAAS,MAAM,OAAO,SAAS,IAAI;EAEzC,IAAI,CAAC,QAAQ;GACX,MAAM,cAAc,MAAM,OAAO,WAAW,KAAK,IAAI;GACrD,OAAO,MACL,YAAY,SAAS,IACjB,uBAAuB,KAAK,KAAK,mBAAmB,YAAY,KAAK,IAAI,EAAE,KAC3E,uCAAuC,KAAK,KAAK,GACvD;EACF;EAEA,OAAO,KAAK,MAAM;CACpB,CACF;CAEA,OAAO,aACL,cACA;EACE,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO;GACpB,MAAM,WAAW,SAAS;GAC1B,OAAO,YAAY,SAAS;GAC5B,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS;GAC9B,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;GAC7B,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS;GAC3B,OAAO,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,iDAAiD;EACzF,CAAC;CACH,GACA,OAAO,SAAS,KAAK,MAAM,OAAO,UAAU,IAAI,CAAC,CACnD;CAEA,OAAO,aACL,WACA;EACE,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO,EAAE,QAAQ,WAAW,CAAC;CAC9C,GACA,OAAO,EAAE,aAAa;EACpB,MAAM,SAAS,MAAM,OAAO,OAAO,MAAM;EAEzC,IAAI,CAAC,QAAQ;GACX,MAAM,cAAc,MAAM,OAAO,WAAW,MAAM;GAClD,OAAO,MACL,YAAY,SAAS,IACjB,qBAAqB,OAAO,mBAAmB,YAAY,KAAK,IAAI,EAAE,KACtE,qBAAqB,OAAO,oBAClC;EACF;EAEA,OAAO,KAAK,MAAM;CACpB,CACF;AACF"}

package/lib/data-client.d.ts

@@ -1,53 +1,132 @@
-import { GetItemArgs, IndexItem, ItemKind, ListItemsArgs, SearchDocsArgs } from './types';
+import { GetItemArgs, IndexItem, ListItemsArgs, SearchDocsArgs, SectionRecord } from './types';
+/** Fetches and caches the static MCP data published alongside the docs site */
 export declare class MantineMcpDataClient {
     private readonly baseUrl;
     private readonly timeoutMs;
     private indexCache;
-    private itemCache;
+    private indexEtag;
+    private indexCheckedAt;
+    private sectionsCache;
+    private docCache;
+    private scorer;
     constructor(baseUrl?: string, timeoutMs?: number);
     private fetchJson;
+    /**
+     * Re-fetches the index if the published copy changed since it was cached.
+     *
+     * Best-effort: a revalidation failure (network blip, non-ok response) is logged and
+     * swallowed so the still-good cached index keeps serving the in-flight request instead of
+     * failing it outright.
+     */
+    private revalidateIndex;
     getIndex(): Promise<IndexItem[]>;
+    getSections(): Promise<SectionRecord[]>;
+    private getScorer;
+    private getDocData;
     listItems(args?: ListItemsArgs): Promise<IndexItem[]>;
-    private scoreMatch;
-    searchDocs(args: SearchDocsArgs): Promise<{
+    findItem(args: GetItemArgs): Promise<IndexItem | null>;
+    /** Names close to a failed lookup, for a helpful error message */
+    suggestFor(name: string): Promise<string[]>;
+    search(args: SearchDocsArgs): Promise<{
         id: string;
         name: string;
-        kind: ItemKind;
-        package: string;
+        kind: import("./types").DocKind;
+        package: string | undefined;
         route: string;
+        docsUrl: string;
         description: string;
+        section: string | undefined;
+        heading: string | undefined;
+        snippet: string | undefined;
         score: number;
     }[]>;
-    private getItemDataById;
-    findItem(args: GetItemArgs): Promise<IndexItem | null>;
-    getItemDoc(args: GetItemArgs): Promise<{
-        item: {
-            id: string;
-            name: string;
-            kind: ItemKind;
-            package: string;
-            route: string;
-            description: string;
-            llmUrl: string;
-        };
+    getDoc(args: GetItemArgs): Promise<{
+        item: IndexItem;
+        mode: "full";
         markdown: string;
-    } | null>;
-    getItemProps(args: GetItemArgs): Promise<{
-        item: {
-            id: string;
-            name: string;
-            kind: ItemKind;
-            package: string;
-            route: string;
-            description: string;
-        };
-        props: {
-            name: string;
-            description?: string;
-            required?: boolean;
-            defaultValue?: unknown;
-            type?: unknown;
-            sourceComponent: string;
+        availableSections?: undefined;
+        heading?: undefined;
+        intro?: undefined;
+        sections?: undefined;
+        source?: undefined;
+        docs?: undefined;
+    } | {
+        item: IndexItem;
+        mode: "section-not-found";
+        availableSections: string[];
+        markdown?: undefined;
+        heading?: undefined;
+        intro?: undefined;
+        sections?: undefined;
+        source?: undefined;
+        docs?: undefined;
+    } | {
+        item: IndexItem;
+        mode: "section";
+        heading: string;
+        markdown: string;
+        availableSections?: undefined;
+        intro?: undefined;
+        sections?: undefined;
+        source?: undefined;
+        docs?: undefined;
+    } | {
+        item: IndexItem;
+        mode: "outline";
+        intro: string;
+        sections: {
+            slug: string;
+            heading: string;
         }[];
+        source: string | undefined;
+        docs: string | undefined;
+        markdown?: undefined;
+        availableSections?: undefined;
+        heading?: undefined;
+    } | null>;
+    /** The section that most plausibly documents a page's API, when no structured props or signature exist */
+    private findApiSection;
+    getProps(args: GetItemArgs): Promise<{
+        item: IndexItem;
+        kind: "props";
+        props: import("./types").PropData[];
+        signature?: undefined;
+        exportedTypeNames?: undefined;
+        message?: undefined;
+        suggestedSection?: undefined;
+        availableSections?: undefined;
+    } | {
+        item: IndexItem;
+        kind: "signature";
+        signature: string;
+        exportedTypeNames: string[] | null;
+        props?: undefined;
+        message?: undefined;
+        suggestedSection?: undefined;
+        availableSections?: undefined;
+    } | {
+        item: IndexItem;
+        kind: "sections";
+        message: string;
+        suggestedSection: string | undefined;
+        availableSections: string[];
+        props?: undefined;
+        signature?: undefined;
+        exportedTypeNames?: undefined;
+    } | null>;
+    getApi(symbol: string): Promise<{
+        item: IndexItem;
+        signature: string | null;
+        exportedTypeNames: string[] | null;
+        propsCount: number;
+        suggestedSection: string | undefined;
+        availableSections: string[];
+    } | {
+        item: IndexItem;
+        signature: string | null;
+        exportedTypeNames: string[] | null;
+        propsCount: number;
+        suggestedSection?: undefined;
+        availableSections?: undefined;
     } | null>;
 }

package/lib/search.d.ts

@@ -0,0 +1,17 @@
+import { IndexItem, SectionRecord } from './types';
+/** A scoring function pair built against a fixed corpus's document-frequency statistics */
+export interface SearchScorer {
+    scoreItem(item: IndexItem, query: string): number;
+    scoreSection(section: SectionRecord, query: string): number;
+}
+/**
+ * Builds an IDF-weighted scorer over a fixed corpus.
+ *
+ * Document frequency is computed lazily per token and cached for the lifetime of the
+ * returned scorer, so a common token like "a" contributes almost nothing to a match while
+ * a rare token like "zod" dominates it. Callers should rebuild the scorer whenever `index`
+ * or `sections` actually change.
+ */
+export declare function createSearchScorer(index: IndexItem[], sections: SectionRecord[]): SearchScorer;
+/** Returns names close enough to a failed lookup to be worth suggesting */
+export declare function suggestNames(index: IndexItem[], query: string, limit?: number): string[];

package/lib/server.d.ts

@@ -1 +1,2 @@
+/** Starts the Mantine documentation MCP server over stdio */
 export declare function startServer(): void;

package/lib/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import { MantineMcpDataClient } from './data-client';
+/** Registers every Mantine documentation tool on an MCP server instance */
+export declare function registerTools(server: McpServer, client: MantineMcpDataClient): void;