@assistant-ui/mcp-docs-server 0.1.1

package/.docs/raw/docs/ui/ThreadList.mdx

@@ -0,0 +1,49 @@
+---
+title: ThreadList
+---
+
+import { Steps, Step } from "fumadocs-ui/components/steps";
+import { ThreadListSample } from "../../../components/samples/threadlist-sample";
+
+## Overview
+
+The ThreadList component lets the user switch between threads.
+
+<ThreadListSample />
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add `thread-list`
+
+```sh
+npx shadcn@latest add "https://r.assistant-ui.com/thread-list"
+```
+
+This adds a `/components/assistant-ui/thread-list.tsx` file to your project, which you can adjust as needed.
+
+  </Step>
+  <Step>
+
+### Use in your application
+
+```tsx title="/app/page.tsx" {1,5-6}
+import { Thread } from "@/components/assistant-ui/thread";
+import { ThreadList } from "@/components/assistant-ui/thread-list";
+
+export default function Home() {
+  return (
+    <div className="grid h-full grid-cols-[200px_1fr]">
+      <ThreadList />
+      <Thread />
+    </div>
+  );
+}
+```
+
+  </Step>
+</Steps>
+
+

package/.docs/raw/docs/ui/ToolFallback.mdx

@@ -0,0 +1,64 @@
+---
+title: ToolFallback
+---
+
+import { Steps, Step } from "fumadocs-ui/components/steps";
+
+## Overview
+
+The ToolFallback component displays a default ToolUI for tools that do not have a dedicated ToolUI.
+
+## Getting Started
+
+<Steps>
+  <Step>
+
+### Add `tool-fallback`
+
+```sh
+npx shadcn@latest add "https://r.assistant-ui.com/tool-fallback"
+```
+
+This adds a `/components/assistant-ui/tool-fallback.tsx` file to your project, which you can adjust as needed.
+
+  </Step>
+  <Step>
+
+### Use it in your application
+
+Pass the `ToolFallback` component to the `MessagePrimitive.Content` component
+
+```tsx twoslash title="/components/assistant-ui/thread.tsx" {1,11}
+// @filename: /components/assistant-ui/tool-fallback.tsx
+import { FC } from "react";
+export const ToolFallback: FC = () => null;
+
+// @filename: ./thread.tsx
+import { FC } from "react";
+import { MessagePrimitive } from "@assistant-ui/react";
+import { Avatar, AvatarFallback } from "@/components/ui/avatar";
+
+const AssistantActionBar: FC = () => null;
+const BranchPicker: FC<{ className?: string }> = () => null;
+
+// ---cut---
+import { ToolFallback } from "@/components/assistant-ui/tool-fallback";
+
+const AssistantMessage: FC = () => {
+  return (
+    <MessagePrimitive.Root className="...">
+      <div className="...">
+        <MessagePrimitive.Content
+          components={{ tools: { Fallback: ToolFallback } }}
+        />
+      </div>
+      <AssistantActionBar />
+
+      <BranchPicker className="..." />
+    </MessagePrimitive.Root>
+  );
+};
+```
+
+  </Step>
+</Steps>

package/.docs/raw/docs/ui/primitives/Thread.mdx

@@ -0,0 +1,197 @@
+---
+title: Thread
+---
+
+A conversation between a user and an assistant.
+
+import { ParametersTable } from "@/components/docs";
+
+## Anatomy
+
+```tsx
+import { ThreadPrimitive } from "@assistant-ui/react";
+
+const Thread = () => (
+  <ThreadPrimitive.Root>
+    <ThreadPrimitive.Viewport>
+      <ThreadPrimitive.Empty>...</ThreadPrimitive.Empty>
+      <ThreadPrimitive.Messages components={...} />
+    </ThreadPrimitive.Viewport>
+    <Composer />
+  </ThreadPrimitive.Root>
+);
+```
+
+## API Reference
+
+### Root
+
+Contains all parts of the thread.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadPrimitiveRootProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### Viewport
+
+The scrollable area containing all messages. Anchors scroll to the bottom as new messages are added.
+
+This primitive renders a `<div>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadPrimitiveViewportProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+    {
+      name: "autoScroll",
+      type: "boolean",
+      default: "true",
+      description:
+        "Whether to automatically scroll to the bottom of the viewport when new messages are added while the viewport is was previously scrolled to the bottom.",
+    },
+  ]}
+/>
+
+### Messages
+
+Renders all messages. This primitive renders a separate component for each message.
+
+<ParametersTable
+  type="ThreadPrimitiveMessagesProps"
+  parameters={[
+    {
+      name: "components",
+      type: "MessageComponents",
+      description: "The component to render for each message.",
+      children: [
+        {
+          type: "MessageComponents",
+          parameters: [
+            {
+              name: "Message",
+              type: "ComponentType",
+              description: "The component to render for each message.",
+            },
+            {
+              name: "UserMessage",
+              type: "ComponentType",
+              description: "The component to render for user messages.",
+            },
+            {
+              name: "EditComposer",
+              type: "ComponentType",
+              description:
+                "The component to render for user messages that are being edited.",
+            },
+            {
+              name: "AssistantMessage",
+              type: "ComponentType",
+              description: "The component to render for assistant messages.",
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+### Empty
+
+Renders children only when there are no messages.
+
+### ScrollToBottom
+
+A button to scroll the viewport to the bottom. Disabled when the viewport is already at bottom.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+<ParametersTable
+  type="ThreadPrimitiveScrollToBottomProps"
+  parameters={[
+    {
+      name: "asChild",
+    },
+  ]}
+/>
+
+### `ThreadPrimitive.Suggestion`
+
+Shows a suggestion to the user. When the user clicks on the suggestion, the composer's value is set to the suggestion's prompt.
+
+This primitive renders a `<button>` element unless `asChild` is set.
+
+```tsx
+import { ThreadPrimitive } from "@assistant-ui/react";
+
+const Suggestion = () => {
+  return (
+    <ThreadPrimitive.Suggestion
+      prompt="I need help with product search"
+      method="replace"
+      autoSend
+    />
+  );
+};
+```
+
+<ParametersTable
+  type="ThreadPrimitiveSuggestionProps"
+  parameters={[
+    {
+      name: "prompt",
+      type: "string",
+      description: "The suggestion's prompt.",
+    },
+    {
+      name: "method",
+      type: "'replace'",
+      description:
+        "How does the suggestion interact with the composer's existing value.",
+    },
+    {
+      name: "autoSend",
+      type: "boolean",
+      description:
+        "Whether to automatically send the suggestion when the user clicks on it.",
+      default: "false",
+    },
+  ]}
+/>
+
+### If
+
+Renders children if a condition is met.
+
+<ParametersTable
+  type="ThreadPrimitiveIfProps"
+  parameters={[
+    {
+      name: "empty",
+      type: "boolean | undefined",
+      description: "Render children if the thread is empty.",
+    },
+    {
+      name: "running",
+      type: "boolean | undefined",
+      description: "Render children if the thread is running.",
+    },
+  ]}
+/>
+
+```tsx
+<Thread.If empty>
+  {/* equivalent to <Thread.Empty> */}
+</Thread.If>
+<Thread.If empty={false}>
+  {/* rendered if thread is not empty */}
+</Thread.If>
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentbaseAI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+# Assistant-UI MCP Docs Server
+
+A Model Context Protocol (MCP) server that provides AI assistants with direct access to assistant-ui's documentation and examples.
+
+> **📖 Full Documentation**  
+> For detailed installation instructions, troubleshooting, and advanced usage, visit the [complete documentation](https://www.assistant-ui.com/docs/mcp-docs-server).
+
+## Installation
+
+### Claude Code
+
+```bash
+# Add to current project
+claude mcp add assistant-ui -- npx -y @assistant-ui/mcp-docs-server
+
+# Or add globally for all projects
+claude mcp add --scope user assistant-ui -- npx -y @assistant-ui/mcp-docs-server
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "assistant-ui": {
+      "command": "npx",
+      "args": ["-y", "@assistant-ui/mcp-docs-server"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "assistant-ui": {
+      "command": "npx",
+      "args": ["-y", "@assistant-ui/mcp-docs-server"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "assistant-ui": {
+      "command": "npx",
+      "args": ["-y", "@assistant-ui/mcp-docs-server"]
+    }
+  }
+}
+```
+
+### VSCode
+
+Add to `~/.vscode/mcp.json` (Windows users: see [full docs](https://www.assistant-ui.com/docs/mcp-docs-server) for Windows-specific config):
+
+```json
+{
+  "servers": {
+    "assistant-ui": {
+      "command": "npx",
+      "args": ["-y", "@assistant-ui/mcp-docs-server"],
+      "type": "stdio"
+    }
+  }
+}
+```
+
+### Zed
+
+Add to `settings.json` (open via `cmd+,` or `zed: open settings`):
+
+```json
+{
+  "context_servers": {
+    "assistant-ui": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "@assistant-ui/mcp-docs-server"],
+        "env": {}
+      },
+      "settings": {}
+    }
+  }
+}
+```
+
+## Tools
+
+- **assistantUIDocs** - Retrieve documentation by path
+- **assistantUIExamples** - Access complete example projects
+
+## Managing the Server
+
+### Claude Code
+
+```bash
+# View configured servers
+claude mcp list
+
+# Get server details
+claude mcp get assistant-ui
+
+# Remove the server
+claude mcp remove assistant-ui
+
+# Restart the server
+claude mcp restart assistant-ui
+```
+
+## License
+
+MIT

package/dist/chunk-C7O7EFKU.js

@@ -0,0 +1,38 @@
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+// src/constants.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var ROOT_DIR = join(__dirname, "../../../");
+var PACKAGE_DIR = join(__dirname, "../");
+var EXAMPLES_PATH = join(ROOT_DIR, "examples");
+var DOCS_BASE = join(PACKAGE_DIR, ".docs");
+var DOCS_PATH = join(DOCS_BASE, "raw/docs");
+join(DOCS_BASE, "raw/blog");
+var CODE_EXAMPLES_PATH = join(DOCS_BASE, "organized/code-examples");
+var MDX_EXTENSION = ".mdx";
+var MD_EXTENSION = ".md";
+var MAX_FILE_SIZE = 10 * 1024 * 1024;
+var IS_PREPARE_MODE = process.env.PREPARE === "true";
+
+// src/utils/logger.ts
+var logger = {
+  debug: (message, ...args) => {
+    if (process.env.DEBUG) {
+      console.debug(`[DEBUG] ${message}`, ...args);
+    }
+  },
+  info: (message, ...args) => {
+    if (process.env.PREPARE === "true") {
+      console.log(`[INFO] ${message}`, ...args);
+    }
+  },
+  error: (message, ...args) => {
+    console.error(`[ERROR] ${message}`, ...args);
+  },
+  warn: (message, ...args) => {
+    console.error(`[WARN] ${message}`, ...args);
+  }
+};
+
+export { CODE_EXAMPLES_PATH, DOCS_PATH, EXAMPLES_PATH, IS_PREPARE_MODE, MAX_FILE_SIZE, MDX_EXTENSION, MD_EXTENSION, ROOT_DIR, logger };