@idealyst/mcp-server 1.2.49 → 1.2.51

package/dist/tools/index.d.cts

@@ -102,8 +102,11 @@ interface GetRecipeArgs {
 interface SearchRecipesArgs {
     query: string;
 }
-type ToolName = "list_components" | "get_component_docs" | "get_component_example" | "search_components" | "get_component_types" | "get_component_examples_ts" | "get_cli_usage" | "search_icons" | "get_theme_types" | "get_navigation_types" | "get_translate_guide" | "get_storage_guide" | "list_packages" | "get_package_docs" | "search_packages" | "list_recipes" | "get_recipe" | "search_recipes";
-type ToolArgs = ListComponentsArgs | GetComponentDocsArgs | GetComponentExampleArgs | SearchComponentsArgs | GetComponentTypesArgs | GetComponentExamplesTsArgs | GetCliUsageArgs | SearchIconsArgs | GetThemeTypesArgs | GetNavigationTypesArgs | GetTranslateGuideArgs | GetStorageGuideArgs | ListPackagesArgs | GetPackageDocsArgs | SearchPackagesArgs | ListRecipesArgs | GetRecipeArgs | SearchRecipesArgs;
+interface GetInstallGuideArgs {
+    package: string;
+}
+type ToolName = "list_components" | "get_component_docs" | "get_component_example" | "search_components" | "get_component_types" | "get_component_examples_ts" | "get_cli_usage" | "search_icons" | "get_theme_types" | "get_navigation_types" | "get_translate_guide" | "get_storage_guide" | "list_packages" | "get_package_docs" | "search_packages" | "list_recipes" | "get_recipe" | "search_recipes" | "get_install_guide";
+type ToolArgs = ListComponentsArgs | GetComponentDocsArgs | GetComponentExampleArgs | SearchComponentsArgs | GetComponentTypesArgs | GetComponentExamplesTsArgs | GetCliUsageArgs | SearchIconsArgs | GetThemeTypesArgs | GetNavigationTypesArgs | GetTranslateGuideArgs | GetStorageGuideArgs | ListPackagesArgs | GetPackageDocsArgs | SearchPackagesArgs | ListRecipesArgs | GetRecipeArgs | SearchRecipesArgs | GetInstallGuideArgs;
 
 /**
  * Tool Definitions
@@ -130,6 +133,7 @@ declare const searchPackagesDefinition: ToolDefinition;
 declare const listRecipesDefinition: ToolDefinition;
 declare const getRecipeDefinition: ToolDefinition;
 declare const searchRecipesDefinition: ToolDefinition;
+declare const getInstallGuideDefinition: ToolDefinition;
 /**
  * Array of all tool definitions.
  * Use this to register all tools with an MCP server.
@@ -146,6 +150,11 @@ declare const toolDefinitionMap: Record<string, ToolDefinition>;
  *
  * Implementation functions for all MCP tools.
  * These handlers can be used directly or through an MCP server.
+ *
+ * Component documentation now uses:
+ * - Types: Dynamically loaded from @idealyst/tooling via generated/types.json
+ * - Examples: Type-checked .examples.tsx files in examples/components/
+ * - Metadata: Minimal static metadata (category, description, features, best practices)
  */
 
 /**
@@ -154,10 +163,20 @@ declare const toolDefinitionMap: Record<string, ToolDefinition>;
 declare function listComponents(_args?: ListComponentsArgs): ToolResponse;
 /**
  * Get detailed documentation for a specific component
+ *
+ * Returns:
+ * - Description and category from metadata
+ * - TypeScript props from dynamic types
+ * - Features and best practices from metadata
+ * - Type-checked examples from .examples.tsx files
  */
 declare function getComponentDocs(args: GetComponentDocsArgs): ToolResponse;
 /**
  * Get a code example for a specific component
+ *
+ * Returns the type-checked example file content.
+ * The example_type parameter is kept for API compatibility but all examples
+ * are now in a single .examples.tsx file.
  */
 declare function getComponentExample(args: GetComponentExampleArgs): ToolResponse;
 /**
@@ -170,6 +189,9 @@ declare function searchComponents(args?: SearchComponentsArgs): ToolResponse;
 declare function getComponentTypes(args: GetComponentTypesArgs): ToolResponse;
 /**
  * Get validated TypeScript examples for a component
+ *
+ * These examples are type-checked against the actual component props
+ * to ensure they compile and are correct.
  */
 declare function getComponentExamplesTs(args: GetComponentExamplesTsArgs): ToolResponse;
 /**
@@ -220,6 +242,10 @@ declare function getRecipe(args: GetRecipeArgs): ToolResponse;
  * Search for recipes
  */
 declare function searchRecipes(args: SearchRecipesArgs): ToolResponse;
+/**
+ * Get detailed installation guide for a package
+ */
+declare function getInstallGuide(args: GetInstallGuideArgs): ToolResponse;
 /**
  * Map of all tool handlers by name.
  * Use this for dynamic tool dispatch.
@@ -246,4 +272,4 @@ declare function getComponentRegistry(): Record<string, any>;
  */
 declare function getRegistryThemeValues(): any;
 
-export { type GetCliUsageArgs, type GetComponentDocsArgs, type GetComponentExampleArgs, type GetComponentExamplesTsArgs, type GetComponentTypesArgs, type GetNavigationTypesArgs, type GetPackageDocsArgs, type GetRecipeArgs, type GetStorageGuideArgs, type GetThemeTypesArgs, type GetTranslateGuideArgs, type ListComponentsArgs, type ListPackagesArgs, type ListRecipesArgs, type PropertySchema, type SearchComponentsArgs, type SearchIconsArgs, type SearchPackagesArgs, type SearchRecipesArgs, type ToolArgs, type ToolContent, type ToolDefinition, type ToolHandler, type ToolInputSchema, type ToolName, type ToolResponse, callTool, getAvailableComponents, getCliUsage, getCliUsageDefinition, getComponentDocs, getComponentDocsDefinition, getComponentExample, getComponentExampleDefinition, getComponentExamplesTs, getComponentExamplesTsDefinition, getComponentRegistry, getComponentTypes, getComponentTypesDefinition, getNavigationTypes, getNavigationTypesDefinition, getPackageDocs, getPackageDocsDefinition, getRecipe, getRecipeDefinition, getRegistryThemeValues, getStorageGuide, getStorageGuideDefinition, getThemeTypes, getThemeTypesDefinition, getTranslateGuide, getTranslateGuideDefinition, listComponents, listComponentsDefinition, listPackages, listPackagesDefinition, listRecipes, listRecipesDefinition, searchComponents, searchComponentsDefinition, searchIcons, searchIconsDefinition, searchPackages, searchPackagesDefinition, searchRecipes, searchRecipesDefinition, toolDefinitionMap, toolDefinitions, toolHandlers };
+export { type GetCliUsageArgs, type GetComponentDocsArgs, type GetComponentExampleArgs, type GetComponentExamplesTsArgs, type GetComponentTypesArgs, type GetInstallGuideArgs, type GetNavigationTypesArgs, type GetPackageDocsArgs, type GetRecipeArgs, type GetStorageGuideArgs, type GetThemeTypesArgs, type GetTranslateGuideArgs, type ListComponentsArgs, type ListPackagesArgs, type ListRecipesArgs, type PropertySchema, type SearchComponentsArgs, type SearchIconsArgs, type SearchPackagesArgs, type SearchRecipesArgs, type ToolArgs, type ToolContent, type ToolDefinition, type ToolHandler, type ToolInputSchema, type ToolName, type ToolResponse, callTool, getAvailableComponents, getCliUsage, getCliUsageDefinition, getComponentDocs, getComponentDocsDefinition, getComponentExample, getComponentExampleDefinition, getComponentExamplesTs, getComponentExamplesTsDefinition, getComponentRegistry, getComponentTypes, getComponentTypesDefinition, getInstallGuide, getInstallGuideDefinition, getNavigationTypes, getNavigationTypesDefinition, getPackageDocs, getPackageDocsDefinition, getRecipe, getRecipeDefinition, getRegistryThemeValues, getStorageGuide, getStorageGuideDefinition, getThemeTypes, getThemeTypesDefinition, getTranslateGuide, getTranslateGuideDefinition, listComponents, listComponentsDefinition, listPackages, listPackagesDefinition, listRecipes, listRecipesDefinition, searchComponents, searchComponentsDefinition, searchIcons, searchIconsDefinition, searchPackages, searchPackagesDefinition, searchRecipes, searchRecipesDefinition, toolDefinitionMap, toolDefinitions, toolHandlers };

package/dist/tools/index.d.ts

@@ -102,8 +102,11 @@ interface GetRecipeArgs {
 interface SearchRecipesArgs {
     query: string;
 }
-type ToolName = "list_components" | "get_component_docs" | "get_component_example" | "search_components" | "get_component_types" | "get_component_examples_ts" | "get_cli_usage" | "search_icons" | "get_theme_types" | "get_navigation_types" | "get_translate_guide" | "get_storage_guide" | "list_packages" | "get_package_docs" | "search_packages" | "list_recipes" | "get_recipe" | "search_recipes";
-type ToolArgs = ListComponentsArgs | GetComponentDocsArgs | GetComponentExampleArgs | SearchComponentsArgs | GetComponentTypesArgs | GetComponentExamplesTsArgs | GetCliUsageArgs | SearchIconsArgs | GetThemeTypesArgs | GetNavigationTypesArgs | GetTranslateGuideArgs | GetStorageGuideArgs | ListPackagesArgs | GetPackageDocsArgs | SearchPackagesArgs | ListRecipesArgs | GetRecipeArgs | SearchRecipesArgs;
+interface GetInstallGuideArgs {
+    package: string;
+}
+type ToolName = "list_components" | "get_component_docs" | "get_component_example" | "search_components" | "get_component_types" | "get_component_examples_ts" | "get_cli_usage" | "search_icons" | "get_theme_types" | "get_navigation_types" | "get_translate_guide" | "get_storage_guide" | "list_packages" | "get_package_docs" | "search_packages" | "list_recipes" | "get_recipe" | "search_recipes" | "get_install_guide";
+type ToolArgs = ListComponentsArgs | GetComponentDocsArgs | GetComponentExampleArgs | SearchComponentsArgs | GetComponentTypesArgs | GetComponentExamplesTsArgs | GetCliUsageArgs | SearchIconsArgs | GetThemeTypesArgs | GetNavigationTypesArgs | GetTranslateGuideArgs | GetStorageGuideArgs | ListPackagesArgs | GetPackageDocsArgs | SearchPackagesArgs | ListRecipesArgs | GetRecipeArgs | SearchRecipesArgs | GetInstallGuideArgs;
 
 /**
  * Tool Definitions
@@ -130,6 +133,7 @@ declare const searchPackagesDefinition: ToolDefinition;
 declare const listRecipesDefinition: ToolDefinition;
 declare const getRecipeDefinition: ToolDefinition;
 declare const searchRecipesDefinition: ToolDefinition;
+declare const getInstallGuideDefinition: ToolDefinition;
 /**
  * Array of all tool definitions.
  * Use this to register all tools with an MCP server.
@@ -146,6 +150,11 @@ declare const toolDefinitionMap: Record<string, ToolDefinition>;
  *
  * Implementation functions for all MCP tools.
  * These handlers can be used directly or through an MCP server.
+ *
+ * Component documentation now uses:
+ * - Types: Dynamically loaded from @idealyst/tooling via generated/types.json
+ * - Examples: Type-checked .examples.tsx files in examples/components/
+ * - Metadata: Minimal static metadata (category, description, features, best practices)
  */
 
 /**
@@ -154,10 +163,20 @@ declare const toolDefinitionMap: Record<string, ToolDefinition>;
 declare function listComponents(_args?: ListComponentsArgs): ToolResponse;
 /**
  * Get detailed documentation for a specific component
+ *
+ * Returns:
+ * - Description and category from metadata
+ * - TypeScript props from dynamic types
+ * - Features and best practices from metadata
+ * - Type-checked examples from .examples.tsx files
  */
 declare function getComponentDocs(args: GetComponentDocsArgs): ToolResponse;
 /**
  * Get a code example for a specific component
+ *
+ * Returns the type-checked example file content.
+ * The example_type parameter is kept for API compatibility but all examples
+ * are now in a single .examples.tsx file.
  */
 declare function getComponentExample(args: GetComponentExampleArgs): ToolResponse;
 /**
@@ -170,6 +189,9 @@ declare function searchComponents(args?: SearchComponentsArgs): ToolResponse;
 declare function getComponentTypes(args: GetComponentTypesArgs): ToolResponse;
 /**
  * Get validated TypeScript examples for a component
+ *
+ * These examples are type-checked against the actual component props
+ * to ensure they compile and are correct.
  */
 declare function getComponentExamplesTs(args: GetComponentExamplesTsArgs): ToolResponse;
 /**
@@ -220,6 +242,10 @@ declare function getRecipe(args: GetRecipeArgs): ToolResponse;
  * Search for recipes
  */
 declare function searchRecipes(args: SearchRecipesArgs): ToolResponse;
+/**
+ * Get detailed installation guide for a package
+ */
+declare function getInstallGuide(args: GetInstallGuideArgs): ToolResponse;
 /**
  * Map of all tool handlers by name.
  * Use this for dynamic tool dispatch.
@@ -246,4 +272,4 @@ declare function getComponentRegistry(): Record<string, any>;
  */
 declare function getRegistryThemeValues(): any;
 
-export { type GetCliUsageArgs, type GetComponentDocsArgs, type GetComponentExampleArgs, type GetComponentExamplesTsArgs, type GetComponentTypesArgs, type GetNavigationTypesArgs, type GetPackageDocsArgs, type GetRecipeArgs, type GetStorageGuideArgs, type GetThemeTypesArgs, type GetTranslateGuideArgs, type ListComponentsArgs, type ListPackagesArgs, type ListRecipesArgs, type PropertySchema, type SearchComponentsArgs, type SearchIconsArgs, type SearchPackagesArgs, type SearchRecipesArgs, type ToolArgs, type ToolContent, type ToolDefinition, type ToolHandler, type ToolInputSchema, type ToolName, type ToolResponse, callTool, getAvailableComponents, getCliUsage, getCliUsageDefinition, getComponentDocs, getComponentDocsDefinition, getComponentExample, getComponentExampleDefinition, getComponentExamplesTs, getComponentExamplesTsDefinition, getComponentRegistry, getComponentTypes, getComponentTypesDefinition, getNavigationTypes, getNavigationTypesDefinition, getPackageDocs, getPackageDocsDefinition, getRecipe, getRecipeDefinition, getRegistryThemeValues, getStorageGuide, getStorageGuideDefinition, getThemeTypes, getThemeTypesDefinition, getTranslateGuide, getTranslateGuideDefinition, listComponents, listComponentsDefinition, listPackages, listPackagesDefinition, listRecipes, listRecipesDefinition, searchComponents, searchComponentsDefinition, searchIcons, searchIconsDefinition, searchPackages, searchPackagesDefinition, searchRecipes, searchRecipesDefinition, toolDefinitionMap, toolDefinitions, toolHandlers };
+export { type GetCliUsageArgs, type GetComponentDocsArgs, type GetComponentExampleArgs, type GetComponentExamplesTsArgs, type GetComponentTypesArgs, type GetInstallGuideArgs, type GetNavigationTypesArgs, type GetPackageDocsArgs, type GetRecipeArgs, type GetStorageGuideArgs, type GetThemeTypesArgs, type GetTranslateGuideArgs, type ListComponentsArgs, type ListPackagesArgs, type ListRecipesArgs, type PropertySchema, type SearchComponentsArgs, type SearchIconsArgs, type SearchPackagesArgs, type SearchRecipesArgs, type ToolArgs, type ToolContent, type ToolDefinition, type ToolHandler, type ToolInputSchema, type ToolName, type ToolResponse, callTool, getAvailableComponents, getCliUsage, getCliUsageDefinition, getComponentDocs, getComponentDocsDefinition, getComponentExample, getComponentExampleDefinition, getComponentExamplesTs, getComponentExamplesTsDefinition, getComponentRegistry, getComponentTypes, getComponentTypesDefinition, getInstallGuide, getInstallGuideDefinition, getNavigationTypes, getNavigationTypesDefinition, getPackageDocs, getPackageDocsDefinition, getRecipe, getRecipeDefinition, getRegistryThemeValues, getStorageGuide, getStorageGuideDefinition, getThemeTypes, getThemeTypesDefinition, getTranslateGuide, getTranslateGuideDefinition, listComponents, listComponentsDefinition, listPackages, listPackagesDefinition, listRecipes, listRecipesDefinition, searchComponents, searchComponentsDefinition, searchIcons, searchIconsDefinition, searchPackages, searchPackagesDefinition, searchRecipes, searchRecipesDefinition, toolDefinitionMap, toolDefinitions, toolHandlers };

package/dist/tools/index.js

@@ -12,6 +12,8 @@ import {
   getComponentRegistry,
   getComponentTypes,
   getComponentTypesDefinition,
+  getInstallGuide,
+  getInstallGuideDefinition,
   getNavigationTypes,
   getNavigationTypesDefinition,
   getPackageDocs,
@@ -42,7 +44,7 @@ import {
   toolDefinitionMap,
   toolDefinitions,
   toolHandlers
-} from "../chunk-WJCICXOJ.js";
+} from "../chunk-SRNAGZJL.js";
 export {
   callTool,
   getAvailableComponents,
@@ -57,6 +59,8 @@ export {
   getComponentRegistry,
   getComponentTypes,
   getComponentTypesDefinition,
+  getInstallGuide,
+  getInstallGuideDefinition,
   getNavigationTypes,
   getNavigationTypesDefinition,
   getPackageDocs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/mcp-server",
-  "version": "1.2.49",
+  "version": "1.2.51",
   "description": "MCP server providing documentation and examples for the Idealyst framework",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -49,9 +49,9 @@
   "author": "Idealyst",
   "license": "MIT",
   "dependencies": {
-    "@idealyst/components": "^1.2.49",
-    "@idealyst/navigation": "^1.2.49",
-    "@idealyst/theme": "^1.2.49",
+    "@idealyst/components": "^1.2.51",
+    "@idealyst/navigation": "^1.2.51",
+    "@idealyst/theme": "^1.2.51",
     "@idealyst/tooling": "^1.2.30",
     "@modelcontextprotocol/sdk": "^1.0.4"
   },