@mastra/mcp-docs-server 0.13.5 → 0.13.6

package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx

@@ -3,8 +3,7 @@ title: "Amazon EC2"
 description: "Deploy your Mastra applications to Amazon EC2."
 ---
 
-import { Callout, Steps } from "nextra/components";
-import ServerConfig from "@/components/content-blocks/server-config.mdx";
+import { Callout, Steps, Tabs } from "nextra/components";
 
 ## Amazon EC2
 
@@ -17,50 +16,85 @@ Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
   refer to our [getting started guide](/docs/getting-started/installation)
 </Callout>
 
-### Setting up EC2
+### Prerequisites
+
+- An AWS account with [EC2](https://aws.amazon.com/ec2/) access
+- An EC2 instance running Ubuntu 24+ or Amazon Linux
+- A domain name with an A record pointing to your instance
+- A reverse proxy configured (e.g., using [nginx](https://nginx.org/))
+- SSL certificate configured (e.g., using [Let's Encrypt](https://letsencrypt.org/))
+- Node.js 18+ installed on your instance
+
+### Deployment Steps
 
 <Steps>
 
-#### Log into your AWS console
+#### Clone your Mastra application
 
-Navigate to the [AWS Management Console](https://aws.amazon.com/console/) and sign in to your account.
+Connect to your EC2 instance and clone your repository:
 
-#### Navigate to EC2
+<Tabs items={["Public Repository", "Private Repository"]}>
+<Tabs.Tab>
 
-Head over to **All services** in the left side navigation. Under **Compute**, click on **EC2**.
+```bash copy
+git clone https://github.com/<your-username>/<your-repository>.git
+```
 
-#### Launch a virtual server instance
+</Tabs.Tab>
 
-Click on **Launch instance** to create a new EC2 instance.
+<Tabs.Tab>
+
+```bash copy
+git clone https://<your-username>:<your-personal-access-token>@github.com/<your-username>/<your-repository>.git
+```
 
-#### Configure your instance details
+</Tabs.Tab>
+</Tabs>
 
-Add the following details for your instance:
+Navigate to the repository directory:
 
-- **Name**: Give your instance a descriptive name
-- **Application and OS Images**: For this example, we'll use the **Amazon Linux** environment
-- **Instance type**: Select **t3.micro** (eligible for free tier)
-- **Key pair**: Select an existing key pair or create a new one for secure login
-- **Network settings**: Ensure to **allow HTTPS and HTTP traffic from the internet** by checking the appropriate boxes
+```bash copy
+cd "<your-repository>"
+```
 
-#### Launch your instance
+#### Install dependencies
 
-Review your configuration and click **Launch instance**.
+```bash copy
+npm install
+```
 
-#### Connect to your instance
+#### Set up environment variables
 
-You'll be redirected to a next steps page. You can connect to your instance either:
+Create a `.env` file and add your environment variables:
 
-- **Through the browser**: Click the **Connect** button for browser-based access
-- **Via SSH**: Use your key pair to SSH into the instance (instructions available when you click **Connect**)
+```bash copy
+touch .env
+```
 
-</Steps>
+Edit the `.env` file and add your environment variables:
 
-### Server Configuration
+```bash copy
+OPENAI_API_KEY=<your-openai-api-key>
+# Add other required environment variables
+```
 
-Once you have access to your EC2 instance (either via SSH or browser), follow these steps to set up your server environment:
+#### Build the application
 
-<ServerConfig />
+```bash copy
+npm run build
+```
+
+#### Run the application
+
+```bash copy
+node --import=./.mastra/output/instrumentation.mjs --env-file=".env" .mastra/output/index.mjs
+```
+
+<Callout>
+Your Mastra application will run on port 4111 by default. Ensure your reverse proxy is configured to forward requests to this port.
+</Callout>
+
+</Steps>
 
 ### Connect to your Mastra server
 

package/.docs/raw/deployment/cloud-providers/index.mdx

@@ -1,17 +1,52 @@
 ---
 title: "Cloud Providers"
 description: "Deploy your Mastra applications to popular cloud providers."
-asIndexPage: true
 ---
 
-import { CardGrid, CardGridItem } from "@/components/cards/card-grid";
-
 ## Cloud Providers
 
-Deploy your Mastra applicaitons to popular cloud providers.
+Standalone Mastra applications can be deployed to popular cloud providers, see one of the following guides for more information:
+
+- [Amazon EC2](/docs/deployment/cloud-providers/amazon-ec2)
+- [AWS Lambda](/docs/deployment/cloud-providers/aws-lambda)
+- [Digital Ocean](/docs/deployment/cloud-providers/digital-ocean)
+- [Azure App Services](/docs/deployment/cloud-providers/azure-app-services)
+
+For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/docs/deployment/server) guide.
+
+## Prerequisites
+
+Before deploying to a cloud provider, ensure you have:
+
+- A [Mastra application](/docs/getting-started/installation)
+- Node.js `v20.0` or higher
+- A GitHub repository for your application (required for most CI/CD setups)
+- Domain name management access (for SSL and HTTPS)
+- Basic familiarity with server setup (e.g. Nginx, environment variables)
+
+## LibSQLStore
+
+`LibSQLStore` writes to the local filesystem, which is not supported in cloud environments that use ephemeral file systems. If you're deploying to platforms like **AWS Lambda**, **Azure App Services**, or **Digital Ocean App Platform**, you **must remove** all usage of `LibSQLStore`.
+
+Specifically, ensure you've removed it from both `src/mastra/index.ts` and `src/mastra/agents/weather-agent.ts`:
+
+```typescript filename="src/mastra/index.ts" showLineNumbers
+export const mastra = new Mastra({
+  // ...
+  storage: new LibSQLStore({ // [!code --]
+    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
+    url: ":memory:", // [!code --]
+  })//[!code --]
+});
+```
 
-<CardGrid>
-  <CardGridItem title="Digital Ocean" description="Deploy your Mastra applications to Digital Ocean" href="./cloud-providers/digital-ocean" />
-  <CardGridItem title="Amazon EC2" description="Deploy your Mastra applications to Amazon EC2" href="./cloud-providers/amazon-ec2" />
-  <CardGridItem title="Azure App Services" description="Deploy your Mastra applications to Azure App Services" href="./cloud-providers/azure-app-services" />
-</CardGrid>
+```typescript filename="src/mastra/agents/weather-agent.ts" showLineNumbers
+export const weatherAgent = new Agent({
+ // ..
+ memory: new Memory({  // [!code --]
+   storage: new LibSQLStore({ // [!code --]
+      url: "file:../mastra.db" // path is relative to the .mastra/output directory // [!code --]
+   }) // [!code --]
+ })//  [!code --]
+});
+```

package/.docs/raw/deployment/serverless-platforms/cloudflare-deployer.mdx

@@ -24,6 +24,7 @@ import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
 export const mastra = new Mastra({
   // ...
   deployer: new CloudflareDeployer({
+    scope: "your-account-id",
     projectName: "hello-mastra",
     scope: "",
     auth: {
@@ -36,44 +37,23 @@ export const mastra = new Mastra({
 
 > See the [CloudflareDeployer](/reference/deployer/cloudflare) API reference for all available configuration options.
 
-### Cloudflare API token
-
-In your Cloudflare dashboard, navigate to **Profile** > **API Tokens**, then select **Edit Cloudflare Workers** and click **Use template** to create a token for the `CloudflareDeployer`.
-
-> To learn how to create a Cloudflare API token, see [Create API token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/) in the Cloudflare docs.
-
-## Continuous integration
-In the Cloudflare dashboard, navigate to **Workers** > **Import a repository**. After importing your Mastra project's Git repository, create an application and configure the build settings with:
-
-- **Build command**: `npm run build`
-- **Deploy command**: `cd .mastra/output && npx wrangler deploy`
-
-- **Build command**: `npm run build` (optional)
-
 ## Manual deployment
 
 Manual deployments are also possible using the [Cloudflare Wrangler CLI](https://developers.cloudflare.com/workers/wrangler/install-and-update/). With the Wrangler CLI installed run the following from your project root to deploy your application.
 
+With the Wrangler CLI installed, login and authenticate with your Cloudflare logins:
+
 ```bash copy
-npm run build && wrangler deploy --config .mastra/output/wrangler.json
+npx wrangler login
 ```
 
-> You can also run `wrangler dev --config .mastra/output/wrangler.json` from your project root to test your Mastra application locally.
-
-## Cloudflare secrets
-
-To add secrets to your Cloudflare Workers application, use the Wrangler CLI. Secrets are environment variables that are encrypted and stored securely.
-
-
-For example, to add an API key:
+Run the following to build and deploy your application to Cloudflare
 
 ```bash copy
-npx wrangler secret put OPENAI_API_KEY
+npm run build && wrangler deploy --config .mastra/output/wrangler.json
 ```
 
-When prompted, enter the secret value. The secret will be encrypted and stored securely in your Cloudflare account.
-
-> For more details on managing secrets, see [Environment Variables and Secrets](https://developers.cloudflare.com/workers/configuration/secrets/) in the Cloudflare documentation.
+> You can also run `wrangler dev --config .mastra/output/wrangler.json` from your project root to test your Mastra application locally.
 
 ## Build output
 
@@ -99,13 +79,12 @@ The `CloudflareDeployer` automatically generates a `wrangler.json` configuration
   "compatibility_flags": ["nodejs_compat", "nodejs_compat_populate_process_env"],
   "observability": { "logs": { "enabled": true } },
   "vars": {
-    "OPENAI_API_KEY": "..",
+    "OPENAI_API_KEY": "...",
     "CLOUDFLARE_API_TOKEN": "..."
   }
 }
-```
-
 
+```
 ## Next steps
 
 - [Mastra Client SDK](/docs/client-js/overview)

package/.docs/raw/deployment/serverless-platforms/index.mdx

@@ -19,7 +19,7 @@ For self-hosted Node.js server deployment, see the [Creating A Mastra Server](/d
 
 Before you begin, ensure you have:
 
-- **Node.js** installed (version 18 or higher is recommended)
+- Node.js `v20.0` or higher
 - If using a platform-specific deployer:
   - An account with your chosen platform
   - Required API keys or credentials
@@ -30,23 +30,23 @@ Before you begin, ensure you have:
 
 Specifically, ensure you've removed it from both `src/mastra/index.ts` and `src/mastra/agents/weather-agent.ts`:
 
-```diff filename="src/mastra/index.ts" showLineNumbers
+```typescript filename="src/mastra/index.ts" showLineNumbers
 export const mastra = new Mastra({
   // ...
--  storage: new LibSQLStore({
--    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db
--    url: ":memory:",
--  })
+  storage: new LibSQLStore({ // [!code --]
+    // stores telemetry, evals, ... into memory storage, if it needs to persist, change to file:../mastra.db // [!code --]
+    url: ":memory:", // [!code --]
+  })//[!code --]
 });
 ```
 
-``` diff filename="src/mastra/agents/weather-agent.ts" showLineNumbers
+```typescript filename="src/mastra/agents/weather-agent.ts" showLineNumbers
 export const weatherAgent = new Agent({
-  // ..
--  memory: new Memory({
--    storage: new LibSQLStore({
--      url: "file:../mastra.db" // path is relative to the .mastra/output directory
--    })
--  })
+ // ..
+ memory: new Memory({  // [!code --]
+   storage: new LibSQLStore({ // [!code --]
+      url: "file:../mastra.db" // path is relative to the .mastra/output directory // [!code --]
+   }) // [!code --]
+ })//  [!code --]
 });
 ```