@mastra/mcp-docs-server 0.0.13 → 0.0.14-alpha.1

package/.docs/organized/code-examples/agent.md

@@ -9,57 +9,53 @@
   "version": "0.0.1",
   "dependencies": {
     "@ai-sdk/openai": "latest",
+    "@mastra/client-js": "latest",
     "@mastra/core": "latest",
-    "@mastra/voice-openai": "latest",
+    "@mastra/mcp": "latest",
     "@mastra/memory": "latest",
-    "@mastra/client-js": "latest",
-    "zod": "^3.24.3"
+    "@mastra/voice-openai": "latest",
+    "fetch-to-node": "^2.1.0",
+    "mastra": "latest",
+    "zod": "^3.24.2"
   },
   "pnpm": {
     "overrides": {
       "@mastra/core": "link:../../packages/core",
       "@mastra/voice-openai": "link:../../voice/openai",
       "@mastra/memory": "link:../../packages/memory",
-      "@mastra/client-js": "link:../../client-sdks/client-js"
+      "@mastra/client-js": "link:../../client-sdks/client-js",
+      "@mastra/mcp": "link:../../packages/mcp",
+      "mastra": "link:../../packages/cli"
     }
   },
   "scripts": {
     "start-deployed": "npx bun src/with-deployed.ts",
-    "start": "npx bun src/index.ts"
+    "start": "npx bun src/index.ts",
+    "mastra:dev": "mastra dev"
   },
   "keywords": [],
   "author": "",
   "license": "MIT",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  "packageManager": "pnpm@10.9.0+sha512.0486e394640d3c1fb3c9d43d49cf92879ff74f8516959c235308f5a8f62e2e19528a65cdc2a3058f587cde71eba3d5b56327c8c33a97e4c4051ca48a10ca2d5f"
 }
 
 ```
 
 ### client.ts
 ```typescript
-import { MastraClient } from '@mastra/client-js';
+import { MCPClient } from '@mastra/mcp';
 
 async function main() {
-  const client = new MastraClient({
-    baseUrl: 'http://localhost:4111',
-  });
-
-  const agent = client.getAgent('chefAgent');
-
-  const response = await agent.generate({
-    messages: 'What is the best pasta dish?',
-    threadId: '12334',
-    resourceId: '12334',
+  const mcpClient = new MCPClient({
+    servers: {
+      myMcpServer: {
+        url: new URL('http://localhost:4111/api/servers/myMcpServer/mcp'),
+      },
+    },
   });
 
-  const memoryThread = await client.getMemoryThread('12334', 'chefAgent').getMessages();
-
-  console.log(memoryThread);
-  console.log(response.text);
-
-  const audioResponse = await agent.voice.speak(response.text);
-
-  console.log(audioResponse);
+  const tools = await mcpClient.getTools();
+  console.log('Tools:', tools);
 }
 
 main();
@@ -425,10 +421,15 @@ import { Mastra } from '@mastra/core';
 import { createLogger } from '@mastra/core/logger';
 
 import { chefAgent, chefAgentResponses, dynamicAgent } from './agents/index';
+import { myMcpServer, myMcpServerTwo } from './mcp/server';
 
 export const mastra = new Mastra({
   agents: { chefAgent, chefAgentResponses, dynamicAgent },
-  logger: createLogger({ name: 'Chef', level: 'info' }),
+  logger: createLogger({ name: 'Chef', level: 'debug' }),
+  mcpServers: {
+    myMcpServer,
+    myMcpServerTwo,
+  },
   serverMiddleware: [
     {
       handler: (c, next) => {
@@ -441,6 +442,92 @@ export const mastra = new Mastra({
 
 ```
 
+### mastra/mcp/server.ts
+```typescript
+import { createTool } from '@mastra/core/tools';
+import { MCPServer } from '@mastra/mcp';
+import { z } from 'zod';
+
+export const myMcpServer = new MCPServer({
+  name: 'My Calculation & Data MCP Server',
+  version: '1.0.0',
+  tools: {
+    calculator: createTool({
+      id: 'calculator',
+      description: 'Performs basic arithmetic operations (add, subtract).',
+      inputSchema: z.object({
+        num1: z.number().describe('The first number.'),
+        num2: z.number().describe('The second number.'),
+        operation: z.enum(['add', 'subtract']).describe('The operation to perform.'),
+      }),
+      execute: async ({ context }) => {
+        const { num1, num2, operation } = context;
+        if (operation === 'add') {
+          return num1 + num2;
+        }
+        if (operation === 'subtract') {
+          return num1 - num2;
+        }
+        throw new Error('Invalid operation');
+      },
+    }),
+    fetchWeather: createTool({
+      id: 'fetchWeather',
+      description: 'Fetches a (simulated) weather forecast for a given city.',
+      inputSchema: z.object({
+        city: z.string().describe('The city to get weather for, e.g., London, Paris.'),
+      }),
+      execute: async ({ context }) => {
+        const { city } = context;
+        const temperatures = {
+          london: '15°C',
+          paris: '18°C',
+          tokyo: '22°C',
+        };
+        const temp = temperatures[city.toLowerCase() as keyof typeof temperatures] || '20°C';
+        return `The weather in ${city} is ${temp} and sunny.`;
+      },
+    }),
+  },
+});
+
+export const myMcpServerTwo = new MCPServer({
+  name: 'My Utility MCP Server',
+  version: '1.0.0',
+  tools: {
+    stringUtils: createTool({
+      id: 'stringUtils',
+      description: 'Performs utility operations on strings (uppercase, reverse).',
+      inputSchema: z.object({
+        text: z.string().describe('The input string.'),
+        action: z.enum(['uppercase', 'reverse']).describe('The string action to perform.'),
+      }),
+      execute: async ({ context }) => {
+        const { text, action } = context;
+        if (action === 'uppercase') {
+          return text.toUpperCase();
+        }
+        if (action === 'reverse') {
+          return text.split('').reverse().join('');
+        }
+        throw new Error('Invalid string action');
+      },
+    }),
+    greetUser: createTool({
+      id: 'greetUser',
+      description: 'Generates a personalized greeting.',
+      inputSchema: z.object({
+        name: z.string().describe('The name of the person to greet.'),
+      }),
+      execute: async ({ context }) => {
+        return `Hello, ${context.name}! Welcome to the MCP server.`;
+      },
+    }),
+  },
+});
+
+```
+
 ### mastra/tools/index.ts
 ```typescript
 import { createTool } from '@mastra/core/tools';

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -11,8 +11,8 @@
     "lint": "next lint"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "^1.1.15",
-    "@ai-sdk/react": "^1.1.21",
+    "@ai-sdk/anthropic": "^1.2.11",
+    "@ai-sdk/react": "^1.2.12",
     "@mastra/core": "latest",
     "next": "^15.3.1",
     "react": "^19.0.0",

package/.docs/organized/code-examples/client-side-tools.md

@@ -12,7 +12,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@ai-sdk/openai": "^1.3.9",
+    "@ai-sdk/openai": "^1.3.22",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
     "react": "^19.0.0",

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -14,7 +14,7 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "latest",
-    "@ai-sdk/react": "^1.2.9",
+    "@ai-sdk/react": "^1.2.12",
     "@mastra/core": "latest",
     "@mastra/memory": "latest",
     "@mastra/pg": "latest",

package/.docs/organized/code-examples/fireworks-r1.md

@@ -13,8 +13,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@ai-sdk/anthropic": "^1.1.15",
-    "@ai-sdk/fireworks": "^0.1.14",
+    "@ai-sdk/anthropic": "^1.2.11",
+    "@ai-sdk/fireworks": "^0.2.14",
     "@mastra/core": "latest",
     "@mastra/mcp": "latest",
     "@mastra/memory": "latest",