@maz-ui/mcp 4.8.0 → 4.9.0

package/README.md

@@ -179,13 +179,9 @@ A Model Context Protocol (MCP) server that provides AI assistants with comprehen
 
 The MCP server provides the following tools that AI assistants can use:
 
-- **`get_getting_started`** - Get the getting started guide
-- **`list_all_components`** - Get a complete list of available components
-- **`list_guides`** - List all installation and usage guides
-- **`list_composables`** - List all Vue composables
-- **`list_directives`** - List all Vue directives
-- **`list_plugins`** - List all Vue plugins
-- **`list_helpers`** - List all utility helpers
+- **`search`** — Search across ALL Maz-UI documentation using a powerful unified search engine. Returns ranked results with contextual snippets.
+- **`get_doc`** — Get the complete documentation for a specific item.
+- **`list`** — Browse all available Maz-UI documentation grouped by category.
 
 ## Available Resources
 

package/dist/mcp.d.mts

@@ -1,4 +1,28 @@
 
+interface SectionMetadata {
+    title: string;
+    level: number;
+    content: string;
+}
+interface DocumentMetadata {
+    name: string;
+    displayName: string;
+    type: string;
+    description: string;
+    tags: string[];
+    props?: string[];
+    slots?: string[];
+    events?: string[];
+    sections: SectionMetadata[];
+}
+
+type DocumentType = 'component' | 'guide' | 'composable' | 'directive' | 'plugin' | 'helper';
+interface Document {
+    name: string;
+    type: DocumentType;
+    content: string;
+    metadata: DocumentMetadata;
+}
 interface DocumentationDiagnostics {
     components: {
         total: number;
@@ -46,6 +70,7 @@ declare class DocumentationService {
     private readonly directivesDir;
     private readonly pluginsDir;
     private readonly helpersDir;
+    private readonly metadataExtractor;
     constructor();
     private pascalToKebabCase;
     private readMarkdownFile;
@@ -62,6 +87,8 @@ declare class DocumentationService {
     getAllPlugins(): string[];
     getHelperDocumentation(helperName: string): string;
     getAllHelpers(): string[];
+    getAllDocuments(): Document[];
+    private buildDocument;
     getOverview(): string;
     searchDocumentation(query: string): string[];
     getDiagnostics(): DocumentationDiagnostics;
@@ -75,6 +102,7 @@ declare class DocumentationService {
 declare class MazUiMcpServer {
     private server;
     private documentationService;
+    private unifiedSearchService;
     private documentationIndex;
     constructor();
     getDocumentationService(): DocumentationService;
@@ -96,17 +124,15 @@ declare class MazUiMcpServer {
      */
     private getHelperType;
     /**
-     * Fuzzy search implementation
-     */
-    private fuzzySearch;
-    /**
-     * Calculate fuzzy match score
-     */
-    private calculateFuzzyScore;
-    /**
-     * Search in documentation index with fuzzy matching
+     * Resolve a document name using intelligent matching:
+     * PascalCase (MazBtn), kebab-case (maz-btn), short name (btn), aliases
      */
-    private searchInIndex;
+    private resolveDocumentName;
+    private handleSearch;
+    private handleList;
+    private handleGetDoc;
+    private handleDocNotFound;
+    private getDocumentContent;
     private setupHandlers;
     run(): Promise<void>;
 }

package/dist/mcp.d.ts

@@ -1,4 +1,28 @@
 
+interface SectionMetadata {
+    title: string;
+    level: number;
+    content: string;
+}
+interface DocumentMetadata {
+    name: string;
+    displayName: string;
+    type: string;
+    description: string;
+    tags: string[];
+    props?: string[];
+    slots?: string[];
+    events?: string[];
+    sections: SectionMetadata[];
+}
+
+type DocumentType = 'component' | 'guide' | 'composable' | 'directive' | 'plugin' | 'helper';
+interface Document {
+    name: string;
+    type: DocumentType;
+    content: string;
+    metadata: DocumentMetadata;
+}
 interface DocumentationDiagnostics {
     components: {
         total: number;
@@ -46,6 +70,7 @@ declare class DocumentationService {
     private readonly directivesDir;
     private readonly pluginsDir;
     private readonly helpersDir;
+    private readonly metadataExtractor;
     constructor();
     private pascalToKebabCase;
     private readMarkdownFile;
@@ -62,6 +87,8 @@ declare class DocumentationService {
     getAllPlugins(): string[];
     getHelperDocumentation(helperName: string): string;
     getAllHelpers(): string[];
+    getAllDocuments(): Document[];
+    private buildDocument;
     getOverview(): string;
     searchDocumentation(query: string): string[];
     getDiagnostics(): DocumentationDiagnostics;
@@ -75,6 +102,7 @@ declare class DocumentationService {
 declare class MazUiMcpServer {
     private server;
     private documentationService;
+    private unifiedSearchService;
     private documentationIndex;
     constructor();
     getDocumentationService(): DocumentationService;
@@ -96,17 +124,15 @@ declare class MazUiMcpServer {
      */
     private getHelperType;
     /**
-     * Fuzzy search implementation
-     */
-    private fuzzySearch;
-    /**
-     * Calculate fuzzy match score
-     */
-    private calculateFuzzyScore;
-    /**
-     * Search in documentation index with fuzzy matching
+     * Resolve a document name using intelligent matching:
+     * PascalCase (MazBtn), kebab-case (maz-btn), short name (btn), aliases
      */
-    private searchInIndex;
+    private resolveDocumentName;
+    private handleSearch;
+    private handleList;
+    private handleGetDoc;
+    private handleDocNotFound;
+    private getDocumentContent;
     private setupHandlers;
     run(): Promise<void>;
 }