@assistant-ui/mcp-docs-server 0.2.2 → 0.3.0

package/README.md

@@ -1,70 +1,43 @@
 # `@assistant-ui/mcp-docs-server`
 
-Model Context Protocol (MCP) server that gives AI assistants direct access to assistant-ui's documentation and example projects. Exposes `assistantUIDocs` (retrieve documentation by path), `assistantUIExamples` (access complete example projects), and `assistantUISearch` (keyword search across the bundled docs), and serves the same docs and examples as readable MCP **resources** (`aui-docs:///{path}`, `aui-example:///{name}`).
+`@assistant-ui/mcp-docs-server` is a stdio proxy for the live hosted assistant-ui documentation MCP endpoint. It forwards JSON-RPC messages to `https://www.assistant-ui.com/mcp`, so stdio clients always use the current documentation without downloading a bundled snapshot.
 
-> [!NOTE]
-> Detailed installation, troubleshooting, and advanced usage at [assistant-ui.com/docs/llm#mcp](https://www.assistant-ui.com/docs/llm#mcp).
+## Zed
 
-## Installation
-
-### Claude Code
-
-```bash
-claude mcp add assistant-ui -- npx -y @assistant-ui/mcp-docs-server
-# or globally for all projects
-claude mcp add --scope user assistant-ui -- npx -y @assistant-ui/mcp-docs-server
-```
-
-### Claude Desktop
-
-Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+Add the server to your Zed settings:
 
 ```json
 {
-  "mcpServers": {
+  "context_servers": {
     "assistant-ui": {
-      "command": "npx",
-      "args": ["-y", "@assistant-ui/mcp-docs-server"]
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@assistant-ui/mcp-docs-server"]
+      }
     }
   }
 }
 ```
 
-### Cursor / Windsurf
-
-Add to `.cursor/mcp.json` (or `~/.cursor/mcp.json`) for Cursor, or `~/.codeium/windsurf/mcp_config.json` for Windsurf, using the same `mcpServers` block as above.
-
-### VS Code
+## Claude Desktop
 
-Add to `.vscode/mcp.json`:
+Add the server to your Claude Desktop configuration:
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "assistant-ui": {
       "command": "npx",
-      "args": ["-y", "@assistant-ui/mcp-docs-server"],
-      "type": "stdio"
+      "args": ["-y", "@assistant-ui/mcp-docs-server"]
     }
   }
 }
 ```
 
-### Zed
+## HTTP clients
 
-Add to `settings.json`:
+Clients that support Streamable HTTP should connect to `https://www.assistant-ui.com/mcp` directly.
 
-```json
-{
-  "context_servers": {
-    "assistant-ui": {
-      "command": {
-        "path": "npx",
-        "args": ["-y", "@assistant-ui/mcp-docs-server"]
-      }
-    }
-  }
-}
-```
+## Endpoint override
 
-To list, get, or remove the server, use your editor's MCP management commands.
+Set `ASSISTANT_UI_MCP_URL` to override the hosted endpoint, for example when testing against a local MCP server.

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import { McpServer } from "@modelcontextprotocol/server";
+import { runProxy } from "./proxy.js";
 //#region src/index.d.ts
-declare const server: McpServer;
 declare function runServer(): Promise<void>;
 //#endregion
-export { runServer, server };
+export { runProxy, runServer };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;cAsBa,QAAM;iBAqFG,aAAS"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;iBAIsB,aAAS"}

package/dist/index.js

@@ -1,101 +1,13 @@
-import { PACKAGE_DIR } from "./constants.js";
-import { logger } from "./utils/logger.js";
-import { docsTools } from "./tools/docs.js";
-import { examplesTools } from "./tools/examples.js";
-import { searchTools } from "./tools/search.js";
-import { xuluxTemplateDetailsTool, xuluxTemplatePreviewTool, xuluxTemplatesListTool } from "./tools/xulux-templates.js";
-import { xuluxPlaygroundPrompt } from "./prompts/xulux-playground.js";
-import { registerResources } from "./tools/resources.js";
-import { join } from "node:path";
-import { McpServer } from "@modelcontextprotocol/server";
-import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
-import { readFileSync } from "node:fs";
+import { runProxy } from "./proxy.js";
 //#region src/index.ts
-const packageJson = JSON.parse(readFileSync(join(PACKAGE_DIR, "package.json"), "utf-8"));
-const server = new McpServer({
-	name: "assistant-ui-docs",
-	version: packageJson.version
-});
-server.registerTool(docsTools.name, {
-	title: "assistant-ui Documentation",
-	description: docsTools.description,
-	inputSchema: docsTools.parameters,
-	annotations: {
-		readOnlyHint: true,
-		openWorldHint: false
-	}
-}, docsTools.execute);
-server.registerTool(examplesTools.name, {
-	title: "assistant-ui Examples",
-	description: examplesTools.description,
-	inputSchema: examplesTools.parameters,
-	annotations: {
-		readOnlyHint: true,
-		openWorldHint: false
-	}
-}, examplesTools.execute);
-server.registerTool(searchTools.name, {
-	title: "Search assistant-ui Documentation",
-	description: searchTools.description,
-	inputSchema: searchTools.parameters,
-	annotations: {
-		readOnlyHint: true,
-		openWorldHint: false
-	}
-}, searchTools.execute);
-server.registerTool(xuluxTemplatesListTool.name, {
-	title: "assistant-ui Templates",
-	description: xuluxTemplatesListTool.description,
-	inputSchema: xuluxTemplatesListTool.parameters,
-	annotations: {
-		readOnlyHint: true,
-		openWorldHint: true
-	}
-}, xuluxTemplatesListTool.execute);
-server.registerTool(xuluxTemplateDetailsTool.name, {
-	title: "assistant-ui Template Details",
-	description: xuluxTemplateDetailsTool.description,
-	inputSchema: xuluxTemplateDetailsTool.parameters,
-	annotations: {
-		readOnlyHint: true,
-		openWorldHint: true
-	}
-}, xuluxTemplateDetailsTool.execute);
-server.registerTool(xuluxTemplatePreviewTool.name, {
-	title: "assistant-ui Template Preview URLs",
-	description: xuluxTemplatePreviewTool.description,
-	inputSchema: xuluxTemplatePreviewTool.parameters,
-	annotations: {
-		readOnlyHint: false,
-		openWorldHint: true
-	}
-}, xuluxTemplatePreviewTool.execute);
-server.registerPrompt(xuluxPlaygroundPrompt.name, {
-	title: "assistant-ui Template Workflow",
-	description: xuluxPlaygroundPrompt.description
-}, () => ({ messages: [{
-	role: "user",
-	content: {
-		type: "text",
-		text: xuluxPlaygroundPrompt.text
-	}
-}] }));
-registerResources(server);
 async function runServer() {
-	try {
-		logger.info(`Starting assistant-ui MCP docs server v${packageJson.version}`);
-		const transport = new StdioServerTransport();
-		await server.connect(transport);
-	} catch (error) {
-		logger.error("Failed to start MCP server", error);
-		process.exit(1);
-	}
+	await runProxy();
 }
 if (import.meta.url === `file://${process.argv[1]}`) runServer().catch((error) => {
 	console.error("Failed to start server:", error);
 	process.exit(1);
 });
 //#endregion
-export { runServer, server };
+export { runProxy, runServer };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/server\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/server/stdio\";\nimport { docsTools } from \"./tools/docs.js\";\nimport { examplesTools } from \"./tools/examples.js\";\nimport { searchTools } from \"./tools/search.js\";\nimport {\n  xuluxTemplatesListTool,\n  xuluxTemplateDetailsTool,\n  xuluxTemplatePreviewTool,\n} from \"./tools/xulux-templates.js\";\nimport { xuluxPlaygroundPrompt } from \"./prompts/xulux-playground.js\";\nimport { registerResources } from \"./tools/resources.js\";\nimport { logger } from \"./utils/logger.js\";\nimport { PACKAGE_DIR } from \"./constants.js\";\n\nimport { readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst packageJson = JSON.parse(\n  readFileSync(join(PACKAGE_DIR, \"package.json\"), \"utf-8\"),\n);\n\nexport const server = new McpServer({\n  name: \"assistant-ui-docs\",\n  version: packageJson.version,\n});\n\nserver.registerTool(\n  docsTools.name,\n  {\n    title: \"assistant-ui Documentation\",\n    description: docsTools.description,\n    inputSchema: docsTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  docsTools.execute,\n);\nserver.registerTool(\n  examplesTools.name,\n  {\n    title: \"assistant-ui Examples\",\n    description: examplesTools.description,\n    inputSchema: examplesTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  examplesTools.execute,\n);\nserver.registerTool(\n  searchTools.name,\n  {\n    title: \"Search assistant-ui Documentation\",\n    description: searchTools.description,\n    inputSchema: searchTools.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: false },\n  },\n  searchTools.execute,\n);\n\nserver.registerTool(\n  xuluxTemplatesListTool.name,\n  {\n    title: \"assistant-ui Templates\",\n    description: xuluxTemplatesListTool.description,\n    inputSchema: xuluxTemplatesListTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplatesListTool.execute,\n);\nserver.registerTool(\n  xuluxTemplateDetailsTool.name,\n  {\n    title: \"assistant-ui Template Details\",\n    description: xuluxTemplateDetailsTool.description,\n    inputSchema: xuluxTemplateDetailsTool.parameters,\n    annotations: { readOnlyHint: true, openWorldHint: true },\n  },\n  xuluxTemplateDetailsTool.execute,\n);\nserver.registerTool(\n  xuluxTemplatePreviewTool.name,\n  {\n    title: \"assistant-ui Template Preview URLs\",\n    description: xuluxTemplatePreviewTool.description,\n    inputSchema: xuluxTemplatePreviewTool.parameters,\n    annotations: { readOnlyHint: false, openWorldHint: true },\n  },\n  xuluxTemplatePreviewTool.execute,\n);\n\nserver.registerPrompt(\n  xuluxPlaygroundPrompt.name,\n  {\n    title: \"assistant-ui Template Workflow\",\n    description: xuluxPlaygroundPrompt.description,\n  },\n  () => ({\n    messages: [\n      {\n        role: \"user\" as const,\n        content: { type: \"text\" as const, text: xuluxPlaygroundPrompt.text },\n      },\n    ],\n  }),\n);\n\nregisterResources(server);\n\nexport async function runServer() {\n  try {\n    logger.info(\n      `Starting assistant-ui MCP docs server v${packageJson.version}`,\n    );\n    const transport = new StdioServerTransport();\n    await server.connect(transport);\n  } catch (error) {\n    logger.error(\"Failed to start MCP server\", error);\n    process.exit(1);\n  }\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAM,cAAc,KAAK,MACvB,aAAa,KAAK,aAAa,cAAc,GAAG,OAAO,CACzD;AAEA,MAAa,SAAS,IAAI,UAAU;CAClC,MAAM;CACN,SAAS,YAAY;AACvB,CAAC;AAED,OAAO,aACL,UAAU,MACV;CACE,OAAO;CACP,aAAa,UAAU;CACvB,aAAa,UAAU;CACvB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,UAAU,OACZ;AACA,OAAO,aACL,cAAc,MACd;CACE,OAAO;CACP,aAAa,cAAc;CAC3B,aAAa,cAAc;CAC3B,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,cAAc,OAChB;AACA,OAAO,aACL,YAAY,MACZ;CACE,OAAO;CACP,aAAa,YAAY;CACzB,aAAa,YAAY;CACzB,aAAa;EAAE,cAAc;EAAM,eAAe;CAAM;AAC1D,GACA,YAAY,OACd;AAEA,OAAO,aACL,uBAAuB,MACvB;CACE,OAAO;CACP,aAAa,uBAAuB;CACpC,aAAa,uBAAuB;CACpC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,uBAAuB,OACzB;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAM,eAAe;CAAK;AACzD,GACA,yBAAyB,OAC3B;AACA,OAAO,aACL,yBAAyB,MACzB;CACE,OAAO;CACP,aAAa,yBAAyB;CACtC,aAAa,yBAAyB;CACtC,aAAa;EAAE,cAAc;EAAO,eAAe;CAAK;AAC1D,GACA,yBAAyB,OAC3B;AAEA,OAAO,eACL,sBAAsB,MACtB;CACE,OAAO;CACP,aAAa,sBAAsB;AACrC,UACO,EACL,UAAU,CACR;CACE,MAAM;CACN,SAAS;EAAE,MAAM;EAAiB,MAAM,sBAAsB;CAAK;AACrE,CACF,EACF,EACF;AAEA,kBAAkB,MAAM;AAExB,eAAsB,YAAY;CAChC,IAAI;EACF,OAAO,KACL,0CAA0C,YAAY,SACxD;EACA,MAAM,YAAY,IAAI,qBAAqB;EAC3C,MAAM,OAAO,QAAQ,SAAS;CAChC,SAAS,OAAO;EACd,OAAO,MAAM,8BAA8B,KAAK;EAChD,QAAQ,KAAK,CAAC;CAChB;AACF;AAEA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { runProxy } from \"./proxy.js\";\n\nexport { runProxy };\n\nexport async function runServer() {\n  await runProxy();\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n  void runServer().catch((error) => {\n    console.error(\"Failed to start server:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;AAIA,eAAsB,YAAY;CAChC,MAAM,SAAS;AACjB;AAEA,IAAI,YAAY,QAAQ,UAAU,QAAQ,KAAK,MAC7C,UAAe,CAAC,CAAC,OAAO,UAAU;CAChC,QAAQ,MAAM,2BAA2B,KAAK;CAC9C,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/proxy.d.ts

@@ -0,0 +1,9 @@
+//#region src/proxy.d.ts
+declare function runProxy({ url, stdin, stdout }?: {
+  url?: URL;
+  stdin?: NodeJS.ReadableStream;
+  stdout?: NodeJS.WritableStream;
+}): Promise<void>;
+//#endregion
+export { runProxy };
+//# sourceMappingURL=proxy.d.ts.map

package/dist/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","names":[],"sources":["../src/proxy.ts"],"mappings":";iBAesB,WACpB,KACA,OACA;EAEA,MAAM;EACN,QAAQ,OAAO;EACf,SAAS,OAAO;IACZ"}

package/dist/proxy.js

@@ -0,0 +1,76 @@
+import { StreamableHTTPClientTransport, isInitializeRequest, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/client";
+import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
+//#region src/proxy.ts
+const DEFAULT_URL = "https://www.assistant-ui.com/mcp";
+const logError = (message, error) => {
+	console.error(`assistant-ui MCP proxy: ${message}`, error);
+};
+async function runProxy({ url = new URL(process.env.ASSISTANT_UI_MCP_URL ?? DEFAULT_URL), stdin = process.stdin, stdout = process.stdout } = {}) {
+	const stdio = new StdioServerTransport(stdin, stdout);
+	const http = new StreamableHTTPClientTransport(url);
+	let initializeRequestId;
+	let closing = false;
+	let resolveClosed = () => {};
+	const closed = new Promise((resolve) => {
+		resolveClosed = resolve;
+	});
+	const closeCounterpart = (counterpart) => {
+		if (closing) return;
+		closing = true;
+		counterpart.close().catch((error) => {
+			logError("failed to close transport", error);
+		}).then(resolveClosed);
+	};
+	stdio.onmessage = (message) => {
+		if (isInitializeRequest(message)) initializeRequestId = message.id;
+		http.send(message).catch(async (error) => {
+			logError("failed to forward message to hosted endpoint", error);
+			if (!isJSONRPCRequest(message)) return;
+			await stdio.send({
+				jsonrpc: "2.0",
+				id: message.id,
+				error: {
+					code: -32603,
+					message: "Failed to proxy request to the hosted MCP server"
+				}
+			}).catch((sendError) => {
+				logError("failed to return proxy error response", sendError);
+			});
+		});
+	};
+	http.onmessage = (message) => {
+		if (isJSONRPCResultResponse(message) && message.id === initializeRequestId) {
+			const protocolVersion = message.result?.protocolVersion;
+			if (typeof protocolVersion === "string") http.setProtocolVersion(protocolVersion);
+		}
+		stdio.send(message).catch((error) => {
+			logError("failed to forward message to stdio", error);
+		});
+	};
+	stdio.onerror = (error) => {
+		logError("stdio transport error", error);
+	};
+	http.onerror = (error) => {
+		logError("HTTP transport error", error);
+	};
+	stdio.onclose = () => {
+		closeCounterpart(http);
+	};
+	http.onclose = () => {
+		closeCounterpart(stdio);
+	};
+	try {
+		await http.start();
+		await stdio.start();
+	} catch (error) {
+		closing = true;
+		await Promise.allSettled([http.close(), stdio.close()]);
+		resolveClosed();
+		throw error;
+	}
+	await closed;
+}
+//#endregion
+export { runProxy };
+
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","names":[],"sources":["../src/proxy.ts"],"sourcesContent":["import {\n  StreamableHTTPClientTransport,\n  isInitializeRequest,\n  isJSONRPCRequest,\n  isJSONRPCResultResponse,\n} from \"@modelcontextprotocol/client\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/server/stdio\";\nimport type { Readable, Writable } from \"node:stream\";\n\nconst DEFAULT_URL = \"https://www.assistant-ui.com/mcp\";\n\nconst logError = (message: string, error: unknown) => {\n  console.error(`assistant-ui MCP proxy: ${message}`, error);\n};\n\nexport async function runProxy({\n  url = new URL(process.env.ASSISTANT_UI_MCP_URL ?? DEFAULT_URL),\n  stdin = process.stdin,\n  stdout = process.stdout,\n}: {\n  url?: URL;\n  stdin?: NodeJS.ReadableStream;\n  stdout?: NodeJS.WritableStream;\n} = {}) {\n  const stdio = new StdioServerTransport(stdin as Readable, stdout as Writable);\n  const http = new StreamableHTTPClientTransport(url);\n  let initializeRequestId: string | number | undefined;\n  let closing = false;\n  let resolveClosed = () => {};\n  const closed = new Promise<void>((resolve) => {\n    resolveClosed = resolve;\n  });\n\n  const closeCounterpart = (counterpart: { close(): Promise<void> }) => {\n    if (closing) return;\n    closing = true;\n    void counterpart\n      .close()\n      .catch((error: unknown) => {\n        logError(\"failed to close transport\", error);\n      })\n      .then(resolveClosed);\n  };\n\n  stdio.onmessage = (message) => {\n    if (isInitializeRequest(message)) {\n      initializeRequestId = message.id;\n    }\n\n    void http.send(message).catch(async (error: unknown) => {\n      logError(\"failed to forward message to hosted endpoint\", error);\n      if (!isJSONRPCRequest(message)) return;\n\n      await stdio\n        .send({\n          jsonrpc: \"2.0\",\n          id: message.id,\n          error: {\n            code: -32603,\n            message: \"Failed to proxy request to the hosted MCP server\",\n          },\n        })\n        .catch((sendError: unknown) => {\n          logError(\"failed to return proxy error response\", sendError);\n        });\n    });\n  };\n\n  http.onmessage = (message) => {\n    if (\n      isJSONRPCResultResponse(message) &&\n      message.id === initializeRequestId\n    ) {\n      const protocolVersion = (\n        message.result as { protocolVersion?: unknown } | null\n      )?.protocolVersion;\n      if (typeof protocolVersion === \"string\") {\n        http.setProtocolVersion(protocolVersion);\n      }\n    }\n\n    void stdio.send(message).catch((error: unknown) => {\n      logError(\"failed to forward message to stdio\", error);\n    });\n  };\n\n  stdio.onerror = (error) => {\n    logError(\"stdio transport error\", error);\n  };\n  http.onerror = (error) => {\n    logError(\"HTTP transport error\", error);\n  };\n  stdio.onclose = () => {\n    closeCounterpart(http);\n  };\n  http.onclose = () => {\n    closeCounterpart(stdio);\n  };\n\n  try {\n    await http.start();\n    await stdio.start();\n  } catch (error) {\n    closing = true;\n    await Promise.allSettled([http.close(), stdio.close()]);\n    resolveClosed();\n    throw error;\n  }\n\n  await closed;\n}\n"],"mappings":";;;AASA,MAAM,cAAc;AAEpB,MAAM,YAAY,SAAiB,UAAmB;CACpD,QAAQ,MAAM,2BAA2B,WAAW,KAAK;AAC3D;AAEA,eAAsB,SAAS,EAC7B,MAAM,IAAI,IAAI,QAAQ,IAAI,wBAAwB,WAAW,GAC7D,QAAQ,QAAQ,OAChB,SAAS,QAAQ,WAKf,CAAC,GAAG;CACN,MAAM,QAAQ,IAAI,qBAAqB,OAAmB,MAAkB;CAC5E,MAAM,OAAO,IAAI,8BAA8B,GAAG;CAClD,IAAI;CACJ,IAAI,UAAU;CACd,IAAI,sBAAsB,CAAC;CAC3B,MAAM,SAAS,IAAI,SAAe,YAAY;EAC5C,gBAAgB;CAClB,CAAC;CAED,MAAM,oBAAoB,gBAA4C;EACpE,IAAI,SAAS;EACb,UAAU;EACV,YACG,MAAM,CAAC,CACP,OAAO,UAAmB;GACzB,SAAS,6BAA6B,KAAK;EAC7C,CAAC,CAAC,CACD,KAAK,aAAa;CACvB;CAEA,MAAM,aAAa,YAAY;EAC7B,IAAI,oBAAoB,OAAO,GAC7B,sBAAsB,QAAQ;EAGhC,KAAU,KAAK,OAAO,CAAC,CAAC,MAAM,OAAO,UAAmB;GACtD,SAAS,gDAAgD,KAAK;GAC9D,IAAI,CAAC,iBAAiB,OAAO,GAAG;GAEhC,MAAM,MACH,KAAK;IACJ,SAAS;IACT,IAAI,QAAQ;IACZ,OAAO;KACL,MAAM;KACN,SAAS;IACX;GACF,CAAC,CAAC,CACD,OAAO,cAAuB;IAC7B,SAAS,yCAAyC,SAAS;GAC7D,CAAC;EACL,CAAC;CACH;CAEA,KAAK,aAAa,YAAY;EAC5B,IACE,wBAAwB,OAAO,KAC/B,QAAQ,OAAO,qBACf;GACA,MAAM,kBACJ,QAAQ,QACP;GACH,IAAI,OAAO,oBAAoB,UAC7B,KAAK,mBAAmB,eAAe;EAE3C;EAEA,MAAW,KAAK,OAAO,CAAC,CAAC,OAAO,UAAmB;GACjD,SAAS,sCAAsC,KAAK;EACtD,CAAC;CACH;CAEA,MAAM,WAAW,UAAU;EACzB,SAAS,yBAAyB,KAAK;CACzC;CACA,KAAK,WAAW,UAAU;EACxB,SAAS,wBAAwB,KAAK;CACxC;CACA,MAAM,gBAAgB;EACpB,iBAAiB,IAAI;CACvB;CACA,KAAK,gBAAgB;EACnB,iBAAiB,KAAK;CACxB;CAEA,IAAI;EACF,MAAM,KAAK,MAAM;EACjB,MAAM,MAAM,MAAM;CACpB,SAAS,OAAO;EACd,UAAU;EACV,MAAM,QAAQ,WAAW,CAAC,KAAK,MAAM,GAAG,MAAM,MAAM,CAAC,CAAC;EACtD,cAAc;EACd,MAAM;CACR;CAEA,MAAM;AACR"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@assistant-ui/mcp-docs-server",
-  "version": "0.2.2",
-  "description": "MCP server for assistant-ui documentation and examples",
+  "version": "0.3.0",
+  "description": "Stdio proxy for the hosted assistant-ui documentation MCP server",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -27,21 +27,19 @@
   "files": [
     "dist",
     "src",
-    ".docs",
     "README.md"
   ],
   "sideEffects": false,
   "dependencies": {
-    "@modelcontextprotocol/server": "^2.0.0",
-    "gray-matter": "^4.0.3",
-    "zod": "^4.4.3"
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0"
   },
   "devDependencies": {
+    "@assistant-ui/x-buildutils": "0.0.25",
     "@modelcontextprotocol/core": "^2.0.0",
-    "@types/node": "^26.2.0",
-    "tsx": "^4.23.12",
-    "vitest": "^4.1.10",
-    "@assistant-ui/x-buildutils": "0.0.23"
+    "@types/node": "^26.4.0",
+    "tsx": "^4.23.13",
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public",
@@ -57,10 +55,8 @@
     "url": "https://github.com/assistant-ui/assistant-ui/issues"
   },
   "scripts": {
-    "prepare-docs": "node ./dist/prepare-docs/prepare.js",
-    "build": "aui-build && pnpm prepare-docs",
+    "build": "aui-build",
     "dev": "tsx src/stdio.ts",
-    "pretest": "pnpm build",
     "test": "vitest run",
     "test:watch": "vitest"
   }

package/src/index.ts

@@ -1,121 +1,9 @@
-import { McpServer } from "@modelcontextprotocol/server";
-import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";
-import { docsTools } from "./tools/docs.js";
-import { examplesTools } from "./tools/examples.js";
-import { searchTools } from "./tools/search.js";
-import {
-  xuluxTemplatesListTool,
-  xuluxTemplateDetailsTool,
-  xuluxTemplatePreviewTool,
-} from "./tools/xulux-templates.js";
-import { xuluxPlaygroundPrompt } from "./prompts/xulux-playground.js";
-import { registerResources } from "./tools/resources.js";
-import { logger } from "./utils/logger.js";
-import { PACKAGE_DIR } from "./constants.js";
+import { runProxy } from "./proxy.js";
 
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-
-const packageJson = JSON.parse(
-  readFileSync(join(PACKAGE_DIR, "package.json"), "utf-8"),
-);
-
-export const server = new McpServer({
-  name: "assistant-ui-docs",
-  version: packageJson.version,
-});
-
-server.registerTool(
-  docsTools.name,
-  {
-    title: "assistant-ui Documentation",
-    description: docsTools.description,
-    inputSchema: docsTools.parameters,
-    annotations: { readOnlyHint: true, openWorldHint: false },
-  },
-  docsTools.execute,
-);
-server.registerTool(
-  examplesTools.name,
-  {
-    title: "assistant-ui Examples",
-    description: examplesTools.description,
-    inputSchema: examplesTools.parameters,
-    annotations: { readOnlyHint: true, openWorldHint: false },
-  },
-  examplesTools.execute,
-);
-server.registerTool(
-  searchTools.name,
-  {
-    title: "Search assistant-ui Documentation",
-    description: searchTools.description,
-    inputSchema: searchTools.parameters,
-    annotations: { readOnlyHint: true, openWorldHint: false },
-  },
-  searchTools.execute,
-);
-
-server.registerTool(
-  xuluxTemplatesListTool.name,
-  {
-    title: "assistant-ui Templates",
-    description: xuluxTemplatesListTool.description,
-    inputSchema: xuluxTemplatesListTool.parameters,
-    annotations: { readOnlyHint: true, openWorldHint: true },
-  },
-  xuluxTemplatesListTool.execute,
-);
-server.registerTool(
-  xuluxTemplateDetailsTool.name,
-  {
-    title: "assistant-ui Template Details",
-    description: xuluxTemplateDetailsTool.description,
-    inputSchema: xuluxTemplateDetailsTool.parameters,
-    annotations: { readOnlyHint: true, openWorldHint: true },
-  },
-  xuluxTemplateDetailsTool.execute,
-);
-server.registerTool(
-  xuluxTemplatePreviewTool.name,
-  {
-    title: "assistant-ui Template Preview URLs",
-    description: xuluxTemplatePreviewTool.description,
-    inputSchema: xuluxTemplatePreviewTool.parameters,
-    annotations: { readOnlyHint: false, openWorldHint: true },
-  },
-  xuluxTemplatePreviewTool.execute,
-);
-
-server.registerPrompt(
-  xuluxPlaygroundPrompt.name,
-  {
-    title: "assistant-ui Template Workflow",
-    description: xuluxPlaygroundPrompt.description,
-  },
-  () => ({
-    messages: [
-      {
-        role: "user" as const,
-        content: { type: "text" as const, text: xuluxPlaygroundPrompt.text },
-      },
-    ],
-  }),
-);
-
-registerResources(server);
+export { runProxy };
 
 export async function runServer() {
-  try {
-    logger.info(
-      `Starting assistant-ui MCP docs server v${packageJson.version}`,
-    );
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-  } catch (error) {
-    logger.error("Failed to start MCP server", error);
-    process.exit(1);
-  }
+  await runProxy();
 }
 
 if (import.meta.url === `file://${process.argv[1]}`) {