@jpisnice/shadcn-ui-mcp-server

Instructions

Implementation Reference

• src/tools/blocks/list-blocks.ts:4-47 (handler)

  The handleListBlocks function is the core implementation of the list_blocks tool. It checks the framework, handles React Native specially, and fetches available blocks via axios.getAvailableBlocks(category) for other frameworks, returning formatted JSON content.

  export async function handleListBlocks({ category }: { category?: string }) {
    const framework = getFramework();
  
    if (framework === "react-native") {
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              {
                categories: {},
                totalBlocks: 0,
                availableCategories: [],
                message:
                  "Blocks are not available for React Native framework. The react-native-reusables repository does not provide block templates.",
              },
              null,
              2
            ),
          },
        ],
      };
    }
  
    try {
      const axios = await getAxiosImplementation();
      const blocks = await axios.getAvailableBlocks(category);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(blocks, null, 2),
          },
        ],
      };
    } catch (error) {
      logError("Failed to list blocks", error);
      throw new Error(
        `Failed to list blocks: ${
          error instanceof Error ? error.message : String(error)
        }`
      );
    }
  }

• src/tools/blocks/list-blocks.ts:49-55 (schema)

  The schema export defines the input parameters for the list_blocks tool, specifically the optional 'category' string filter.

  export const schema = {
    category: {
      type: "string",
      description:
        "Filter by category (calendar, dashboard, login, sidebar, products)",
    },
  };

• src/tools/index.ts:17-25 (registration)

  Registration of the handleListBlocks function in the toolHandlers map, which is used by the MCP server to dispatch tool calls.

  export const toolHandlers = {
    get_component: handleGetComponent,
    get_component_demo: handleGetComponentDemo,
    list_components: handleListComponents,
    get_component_metadata: handleGetComponentMetadata,
    get_directory_structure: handleGetDirectoryStructure,
    get_block: handleGetBlock,
    list_blocks: handleListBlocks
  };

• src/tools/index.ts:27-35 (registration)

  Registration of the listBlocksSchema in the toolSchemas map for input validation.

  export const toolSchemas = {
    get_component: getComponentSchema,
    get_component_demo: getComponentDemoSchema,
    list_components: listComponentsSchema,
    get_component_metadata: getComponentMetadataSchema,
    get_directory_structure: getDirectoryStructureSchema,
    get_block: getBlockSchema,
    list_blocks: listBlocksSchema
  };

• src/tools/index.ts:90-97 (registration)

  Definition of the list_blocks tool in the tools export, including name, description, and input schema reference, used for MCP tool listing and capabilities.

  'list_blocks': {
    name: 'list_blocks',
    description: 'Get all available shadcn/ui v4 blocks with categorization',
    inputSchema: {
      type: 'object',
      properties: listBlocksSchema
    }
  }