From 3949c7baa3f8ff8cf21868ad7baebcaaf248dade Mon Sep 17 00:00:00 2001
From: Jack-sh1 <shennalin2@gmail.com>
Date: Fri, 15 May 2026 20:15:39 +0800
Subject: [PATCH] feat(nuxt-mcp-dev): add pagination and filtering for
 list-nuxt-components

Large Nuxt apps may exceed MCP tool token limits when listing all
components at once. Add optional page, pageSize, and filter parameters
to allow clients to paginate through results and search by component name.

Closes #29
---
 packages/nuxt-mcp-dev/src/tools/runtime.ts | 40 ++++++++++++++++++++--
 1 file changed, 37 insertions(+), 3 deletions(-)

diff --git a/packages/nuxt-mcp-dev/src/tools/runtime.ts b/packages/nuxt-mcp-dev/src/tools/runtime.ts
index 41d9491..3393910 100644
--- a/packages/nuxt-mcp-dev/src/tools/runtime.ts
+++ b/packages/nuxt-mcp-dev/src/tools/runtime.ts
@@ -1,6 +1,7 @@
 import type { Component, NuxtPage } from '@nuxt/schema'
 import type { McpToolContext } from '../types'
 import { useNuxt } from '@nuxt/kit'
+import { z } from 'zod'
 
 export function useToolsRuntime(): {
   registerTools: (context: McpToolContext) => void
@@ -66,12 +67,45 @@ export function useToolsRuntime(): {
     mcp.tool(
       'list-nuxt-components',
       'List registered components in the Nuxt app. When adding importing new components, check available components from this tool.',
-      {},
-      async () => {
+      {
+        filter: z.string()
+          .optional()
+          .describe('Filter components by name (case-insensitive substring match)'),
+        page: z.number()
+          .int()
+          .min(1)
+          .optional()
+          .describe('Page number, starts from 1 (default: 1)'),
+        pageSize: z.number()
+          .int()
+          .min(1)
+          .max(200)
+          .optional()
+          .describe('Number of components per page (default: 50, max: 200)'),
+      },
+      async ({ filter, page = 1, pageSize = 50 }) => {
+        let filtered = components
+
+        if (filter) {
+          const keyword = filter.toLowerCase()
+          filtered = filtered.filter(c =>
+            c.pascalName?.toLowerCase().includes(keyword)
+            || c.kebabName?.toLowerCase().includes(keyword),
+          )
+        }
+
+        const total = filtered.length
+        const totalPages = Math.ceil(total / pageSize)
+        const start = (page - 1) * pageSize
+        const paginated = filtered.slice(start, start + pageSize)
+
         return {
           content: [{
             type: 'text',
-            text: JSON.stringify(components, null, 2),
+            text: JSON.stringify({
+              components: paginated,
+              pagination: { page, pageSize, total, totalPages },
+            }, null, 2),
           }],
         }
       },