@mastra/mcp-docs-server 0.13.40 → 0.13.41

package/dist/stdio.js

@@ -102,6 +102,64 @@ function createLogger(server2) {
   };
 }
 var logger = createLogger();
+
+// src/prompts/migration.ts
+var UPGRADE_MESSAGE = `# Migration Guide Upgrade Required
+
+To access migration guides for upgrading to Mastra v1.0-beta, you need to upgrade your mcp-docs-server to the beta version.
+
+## How to Upgrade
+
+The migration tool and prompts are only available in the beta version of the mcp-docs-server.
+
+Visit the installation guide for detailed instructions on how to upgrade to the beta version:
+
+https://mastra.ai/docs/v1/getting-started/mcp-docs-server#installation
+
+Once upgraded, you'll be able to:
+- Browse migration guides with the \`mastraMigration\` tool
+- Use migration prompts like \`upgrade-to-v1\` and \`migration-checklist\`
+- Get step-by-step migration instructions for each breaking change
+- Use automated codemods to handle many migrations automatically
+
+## Why Beta?
+
+The migration guides are specific to the v1.0-beta release and are actively being updated as the beta evolves. The stable (0.x) documentation server doesn't include these guides as they're not relevant to users on the stable version.
+
+---
+
+**Note:** This message is shown because you're currently using the stable (@latest) version of @mastra/mcp-docs-server. Upgrade to @beta to access migration guides and prompts.`;
+var migrationPrompts = [
+  {
+    name: "upgrade-to-v1",
+    description: 'Get a guided migration plan for upgrading from Mastra v0.x to v1.0-beta. Optionally specify an area (e.g., "agent", "workflow") to focus on.',
+    arguments: [
+      {
+        name: "area",
+        description: 'Optional: A specific area to focus the migration guide on (e.g., "agent", "workflow", "tools")',
+        required: false
+      }
+    ]
+  },
+  {
+    name: "migration-checklist",
+    description: "Get a comprehensive checklist for migrating to Mastra v1.0-beta. Lists all breaking changes organized by area."
+  }
+];
+var migrationPromptMessages = {
+  listPrompts: async () => migrationPrompts,
+  getPromptMessages: async () => {
+    return [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: UPGRADE_MESSAGE
+        }
+      }
+    ];
+  }
+};
 var BLOG_BASE_URL = process.env.BLOG_URL || "https://mastra.ai";
 async function fetchBlogPosts() {
   void logger.debug("Fetching list of blog posts");
@@ -1090,6 +1148,93 @@ var examplesTool = {
     }
   }
 };
+var migrationInputSchema = z.object({
+  path: z.string().optional().describe(
+    'Path to the migration guide (e.g., "upgrade-to-v1/agent", "agentnetwork"). If not provided, lists all available migrations.\n\nExample migration paths:\n- agentnetwork\n- upgrade-to-v1/agent\n- upgrade-to-v1/cli\n- upgrade-to-v1/client\n- upgrade-to-v1/evals\n...'
+  ),
+  listSections: z.boolean().optional().describe("Set to true to list all section headers in a migration guide without fetching full content."),
+  sections: z.array(z.string()).optional().describe(
+    "Specific section titles to fetch from the migration guide. If not provided, returns the entire guide. Use this after exploring section headers."
+  ),
+  queryKeywords: z.array(z.string()).optional().describe("Keywords to search across all migration guides. Use this to find guides related to specific topics.")
+});
+var UPGRADE_MESSAGE2 = `# Migration Guide Upgrade Required
+
+To access migration guides for upgrading to Mastra v1.0-beta, you need to upgrade your mcp-docs-server to the beta version.
+
+## How to Upgrade
+
+The migration tool is only available in the beta version of the mcp-docs-server.
+
+1. **Update your MCP server configuration** to use the beta version. Visit the installation guide for detailed instructions:
+
+   https://mastra.ai/docs/v1/getting-started/mcp-docs-server#installation
+
+2. **Restart your MCP server** after updating to pick up the beta version
+
+3. **Access migration guides** - Once upgraded, you'll be able to:
+   - Browse migration guides with the \`mastraMigration\` tool
+   - Get step-by-step migration instructions for each breaking change
+   - Use automated codemods to handle many migrations automatically
+
+## Why Beta?
+
+The migration guides are specific to the v1.0-beta release and are actively being updated as the beta evolves. The stable (0.x) documentation server doesn't include these guides as they're not relevant to users on the stable version.
+
+## Need Help?
+
+If you have questions about upgrading:
+- Check the Mastra documentation at https://mastra.ai/docs
+- Visit the GitHub repository for issues and discussions
+- Join the Mastra community for support
+
+---
+
+**Note:** This message is shown because you're currently using the stable (@latest) version of @mastra/mcp-docs-server. Upgrade to @beta to access migration guides.`;
+var migrationTool = {
+  name: "mastraMigration",
+  description: `Get migration guidance for Mastra version upgrades and breaking changes.
+
+This tool works like a file browser - navigate through directories to find migration guides:
+
+**Step 1: List top-level migrations**
+- Call with no parameters: \`{}\`
+- Shows all top-level migration guides and directories
+
+**Step 2: Navigate into a directory**
+- Add trailing slash to explore: \`{ path: "upgrade-to-v1/" }\`
+- Lists all migration guides in that directory
+
+**Step 3: View a migration guide**
+- Without trailing slash: \`{ path: "upgrade-to-v1/agent" }\`
+- Returns the full migration guide content
+
+**Step 4: Explore guide sections (optional)**
+- List sections: \`{ path: "upgrade-to-v1/agent", listSections: true }\`
+- Get specific sections: \`{ path: "upgrade-to-v1/agent", sections: ["Voice methods"] }\`
+
+**Alternative: Search by keywords**
+- \`{ queryKeywords: ["RuntimeContext", "pagination"] }\`
+
+**Examples:**
+1. List top-level: \`{}\`
+2. Navigate to upgrade-to-v1: \`{ path: "upgrade-to-v1/" }\`
+3. Get agent guide: \`{ path: "upgrade-to-v1/agent" }\`
+4. List guide sections: \`{ path: "upgrade-to-v1/agent", listSections: true }\`
+5. Search: \`{ queryKeywords: ["RuntimeContext"] }\`
+
+**Tip:** Paths ending with \`/\` list directory contents. Paths without \`/\` fetch the migration guide.`,
+  parameters: migrationInputSchema,
+  execute: async (args) => {
+    void logger.debug("Executing mastraMigration tool (stub version)", { args });
+    try {
+      return UPGRADE_MESSAGE2;
+    } catch (error) {
+      void logger.error("Failed to execute mastraMigration tool", error);
+      throw error;
+    }
+  }
+};
 
 // src/index.ts
 var server;
@@ -1110,12 +1255,14 @@ server = new MCPServer({
     mastraDocs: docsTool,
     mastraExamples: examplesTool,
     mastraChanges: changesTool,
+    mastraMigration: migrationTool,
     startMastraCourse,
     getMastraCourseStatus,
     startMastraCourseLesson,
     nextMastraCourseStep,
     clearMastraCourseHistory
-  }
+  },
+  prompts: migrationPromptMessages
 });
 Object.assign(logger, createLogger(server));
 async function runServer() {

package/dist/tools/migration.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const migrationInputSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    listSections: z.ZodOptional<z.ZodBoolean>;
+    sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    queryKeywords?: string[] | undefined;
+    listSections?: boolean | undefined;
+    sections?: string[] | undefined;
+}, {
+    path?: string | undefined;
+    queryKeywords?: string[] | undefined;
+    listSections?: boolean | undefined;
+    sections?: string[] | undefined;
+}>;
+export type MigrationInput = z.infer<typeof migrationInputSchema>;
+export declare const migrationTool: {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        listSections: z.ZodOptional<z.ZodBoolean>;
+        sections: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        queryKeywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path?: string | undefined;
+        queryKeywords?: string[] | undefined;
+        listSections?: boolean | undefined;
+        sections?: string[] | undefined;
+    }, {
+        path?: string | undefined;
+        queryKeywords?: string[] | undefined;
+        listSections?: boolean | undefined;
+        sections?: string[] | undefined;
+    }>;
+    execute: (args: MigrationInput) => Promise<string>;
+};
+//# sourceMappingURL=migration.d.ts.map

package/dist/tools/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/tools/migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAqB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAoClE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;oBAkCF,cAAc;CAUrC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.40",
+  "version": "0.13.41",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.24.1",
-    "@mastra/mcp": "^0.14.2"
+    "@mastra/core": "0.24.2",
+    "@mastra/mcp": "^0.14.3"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.5",
@@ -49,8 +49,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@mastra/core": "0.24.1",
-    "@internal/lint": "0.0.59"
+    "@internal/lint": "0.0.60",
+    "@mastra/core": "0.24.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {