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

package/.docs/raw/memory/working-memory.mdx

@@ -79,7 +79,84 @@ const memory = new Memory({
 });
 ```
 
-If your agent is not properly updating working memory when you expect it to, you can add system instructions on _how_ and _when_ to use this template in your agents `instruction` setting.
+## Designing Effective Templates
+
+A well-structured template keeps the information easy for the agent to parse and update. Treat the
+template as a short form that you want the assistant to keep up to date.
+
+- **Short, focused labels.** Avoid paragraphs or very long headings. Keep labels brief (for example
+  `## Personal Info` or `- Name:`) so updates are easy to read and less likely to be truncated.
+- **Use consistent casing.** Inconsistent capitalization (`Timezone:` vs `timezone:`) can cause messy
+  updates. Stick to Title Case or lower case for headings and bullet labels.
+- **Keep placeholder text simple.** Use hints such as `[e.g., Formal]` or `[Date]` to help the LLM
+  fill in the correct spots.
+- **Abbreviate very long values.** If you only need a short form, include guidance like
+  `- Name: [First name or nickname]` or `- Address (short):` rather than the full legal text.
+- **Mention update rules in `instructions`.** You can instruct how and when to fill or clear parts of
+  the template directly in the agent's `instructions` field.
+
+### Alternative Template Styles
+
+Use a shorter single block if you only need a few items:
+
+```typescript
+const basicMemory = new Memory({
+  options: {
+    workingMemory: {
+      enabled: true,
+      template: `User Facts:\n- Name:\n- Favorite Color:\n- Current Topic:`,
+    },
+  },
+});
+```
+
+You can also store the key facts in a short paragraph format if you prefer a more narrative style:
+
+```typescript
+const paragraphMemory = new Memory({
+  options: {
+    workingMemory: {
+      enabled: true,
+      template: `Important Details:\n\nKeep a short paragraph capturing the user's important facts (name, main goal, current task).`,
+    },
+  },
+});
+```
+
+## Example: Multi-step Retention
+
+Below is a simplified view of how the `User Profile` template updates across a short user
+conversation:
+
+```nohighlight
+# User Profile
+
+## Personal Info
+
+- Name:
+- Location:
+- Timezone:
+
+--- After user says "My name is **Sam** and I'm from **Berlin**" ---
+
+# User Profile
+- Name: Sam
+- Location: Berlin
+- Timezone:
+
+--- After user adds "By the way I'm normally in **CET**" ---
+
+# User Profile
+- Name: Sam
+- Location: Berlin
+- Timezone: CET
+```
+
+The agent can now refer to `Sam` or `Berlin` in later responses without requesting the information
+again because it has been stored in working memory.
+
+If your agent is not properly updating working memory when you expect it to, you can add system
+instructions on _how_ and _when_ to use this template in your agent's `instructions` setting.
 
 ## Examples
 

package/.docs/raw/reference/cli/mcp-docs-server.mdx

@@ -0,0 +1,82 @@
+---
+title: "@mastra/mcp-docs-server"
+description: "Serve Mastra docs, examples and blog posts over MCP"
+---
+
+The `@mastra/mcp-docs-server` package runs a small [Model Context
+Protocol](https://github.com/modelcontextprotocol/mcp) server that makes
+Mastra documentation, code examples, blog posts and changelogs
+queryable by an LLM agent. It can be invoked manually from the command
+line or configured inside an MCP-aware IDE such as Cursor or Windsurf.
+
+## Running from the CLI
+
+```bash
+npx -y @mastra/mcp-docs-server@latest
+```
+
+The command above runs a stdio based MCP server. The process will keep
+reading requests from `stdin` and returning responses on `stdout`. This
+is the same command that IDE integrations use. When run manually it can
+be pointed at the `@wong2/mcp-cli` package for exploration.
+
+### Examples
+
+Rebuild the docs before serving (useful if you've modified docs locally):
+
+```bash
+REBUILD_DOCS_ON_START=true npx -y @mastra/mcp-docs-server@latest
+```
+
+Enable verbose logging while experimenting:
+
+```bash
+DEBUG=1 npx -y @mastra/mcp-docs-server@latest
+```
+
+Serve blog posts from a custom domain:
+
+```bash
+BLOG_URL=https://my-blog.example npx -y @mastra/mcp-docs-server@latest
+```
+
+## Environment variables
+
+`@mastra/mcp-docs-server` honours a few environment variables that tweak
+its behaviour:
+
+- **`REBUILD_DOCS_ON_START`** - when set to `true` the server rebuilds
+  the `.docs` directory before binding to stdio. This can be helpful
+  after editing or adding documentation locally.
+- **`PREPARE`** - the docs build step (`pnpm mcp-docs-server
+  prepare-docs`) looks for `PREPARE=true` to copy Markdown sources from
+  the repository into `.docs`.
+- **`BLOG_URL`** - base URL used for fetching blog posts.
+  Defaults to `https://mastra.ai`.
+- **`DEBUG`** or **`NODE_ENV=development`** - increase logging written
+  to `stderr`.
+
+No other variables are required for a basic run; the server ships with a
+pre-built docs directory.
+
+## Rebuilding with custom docs
+
+The package includes a precompiled copy of the documentation. If you
+want to experiment with additional content you can rebuild the
+`.docs` directory locally:
+
+```bash
+pnpm mcp-docs-server prepare-docs
+```
+
+The script will copy documentation from
+`mastra/docs/src/content/en/docs` and
+`mastra/docs/src/content/en/reference` into the package. Once rebuilt,
+start the server with `REBUILD_DOCS_ON_START=true` so the fresh content
+is served.
+
+A rebuild is only necessary if you need to serve customised docs. For
+regular use you can rely on the published package contents.
+
+For IDE configuration details see the
+[Getting started guide](/docs/getting-started/mcp-docs-server).

package/.docs/raw/reference/deployer/cloudflare.mdx

@@ -133,6 +133,13 @@ The CloudflareDeployer handles environment variables from multiple sources:
 2. **Configuration**: Variables passed through the `env` parameter.
 
 
+## Lint Mastra Project
+Lint your Mastra project to make sure it's fine to build
+```bash
+npx mastra lint
+```
+
+
 ## Build Mastra Project
 
 To build your Mastra project for cloudflare deployment:

package/.docs/raw/reference/deployer/netlify.mdx

@@ -59,6 +59,11 @@ The NetlifyDeployer handles environment variables from multiple sources:
 2. **Configuration**: Variables passed through the Mastra configuration.
 3. **Netlify Dashboard**: Variables can also be managed through Netlify's web interface.
 
+## Lint Mastra Project
+Lint your Mastra project to make sure it's fine to build
+```bash
+npx mastra lint
+```
 
 ## Build Mastra Project
 

package/.docs/raw/reference/deployer/vercel.mdx

@@ -61,6 +61,12 @@ The VercelDeployer handles environment variables from multiple sources:
 
 The deployer automatically synchronizes environment variables between your local development environment and Vercel's environment variable system, ensuring consistency across all deployment environments (production, preview, and development).
 
+## Lint Mastra Project
+Lint your Mastra project to make sure it's fine to build
+```bash
+npx mastra lint
+```
+
 ## Build Mastra Project
 
 To build your Mastra project for Vercel deployment:

package/dist/{chunk-OKBMABZO.js → chunk-JWLYN5OI.js}

@@ -46,8 +46,9 @@ ${file.content}
 \`\`\`
 `).join("\n");
       const totalLines = output.split("\n").length;
-      if (totalLines > 500) {
-        log(`Skipping ${dir.name}: ${totalLines} lines exceeds limit of 500`);
+      const limit = 1e3;
+      if (totalLines > limit) {
+        log(`Skipping ${dir.name}: ${totalLines} lines exceeds limit of ${limit}`);
         continue;
       }
       await fs.writeFile(outputFile, output, "utf-8");

package/dist/prepare-docs/prepare.js

@@ -1 +1 @@
-export { prepare } from '../chunk-OKBMABZO.js';
+export { prepare } from '../chunk-JWLYN5OI.js';

package/dist/stdio.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { fromPackageRoot, prepare } from './chunk-OKBMABZO.js';
+import { fromPackageRoot, prepare } from './chunk-JWLYN5OI.js';
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.0.13",
+  "version": "0.0.14-alpha.1",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,8 +32,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.24.3",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "^0.9.3",
-    "@mastra/mcp": "^0.4.3"
+    "@mastra/core": "^0.9.4-alpha.1",
+    "@mastra/mcp": "^0.5.0-alpha.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.13.8",