@mastra/mcp-docs-server 1.1.28 → 1.1.29-alpha.11

package/.docs/reference/workspace/azure-blob-filesystem.md

@@ -0,0 +1,219 @@
+# AzureBlobFilesystem
+
+Stores files in Azure Blob Storage containers.
+
+> **Info:** For interface details, see [WorkspaceFilesystem Interface](https://mastra.ai/reference/workspace/filesystem).
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/azure
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/azure
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/azure
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/azure
+```
+
+## Usage
+
+Add an `AzureBlobFilesystem` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { AzureBlobFilesystem } from '@mastra/azure/blob'
+
+const workspace = new Workspace({
+  filesystem: new AzureBlobFilesystem({
+    container: 'my-container',
+    connectionString: process.env.AZURE_STORAGE_CONNECTION_STRING,
+  }),
+})
+
+const agent = new Agent({
+  name: 'file-agent',
+  model: 'anthropic/claude-opus-4-6',
+  workspace,
+})
+```
+
+### Account key
+
+Use an account name and account key when you do not want to pass a full connection string:
+
+```typescript
+import { AzureBlobFilesystem } from '@mastra/azure/blob'
+
+const filesystem = new AzureBlobFilesystem({
+  container: 'my-container',
+  accountName: process.env.AZURE_STORAGE_ACCOUNT_NAME,
+  accountKey: process.env.AZURE_STORAGE_ACCOUNT_KEY,
+})
+```
+
+### Shared access signature token
+
+Use a shared access signature (SAS) token with either `accountName` or `endpoint`:
+
+```typescript
+import { AzureBlobFilesystem } from '@mastra/azure/blob'
+
+const filesystem = new AzureBlobFilesystem({
+  container: 'my-container',
+  accountName: process.env.AZURE_STORAGE_ACCOUNT_NAME,
+  sasToken: process.env.AZURE_STORAGE_SAS_TOKEN,
+})
+```
+
+### DefaultAzureCredential
+
+Use `DefaultAzureCredential` when your environment provides Azure identity credentials:
+
+```typescript
+import { AzureBlobFilesystem } from '@mastra/azure/blob'
+
+const filesystem = new AzureBlobFilesystem({
+  container: 'my-container',
+  accountName: process.env.AZURE_STORAGE_ACCOUNT_NAME,
+  useDefaultCredential: true,
+})
+```
+
+Install `@azure/identity` when you use `DefaultAzureCredential`:
+
+**npm**:
+
+```bash
+npm install @azure/identity
+```
+
+**pnpm**:
+
+```bash
+pnpm add @azure/identity
+```
+
+**Yarn**:
+
+```bash
+yarn add @azure/identity
+```
+
+**Bun**:
+
+```bash
+bun add @azure/identity
+```
+
+## Constructor parameters
+
+**container** (`string`): Azure Blob Storage container name
+
+**connectionString** (`string`): Full Azure Storage connection string. Takes priority over other authentication options.
+
+**accountName** (`string`): Azure Storage account name. Required unless you use connectionString or endpoint.
+
+**accountKey** (`string`): Azure Storage account key.
+
+**sasToken** (`string`): Shared access signature token. Requires accountName or endpoint.
+
+**useDefaultCredential** (`boolean`): Use DefaultAzureCredential from @azure/identity. (Default: `false`)
+
+**endpoint** (`string`): Custom Blob service endpoint URL. Used for local development with Azurite.
+
+**prefix** (`string`): Optional prefix for all keys (acts like a subdirectory).
+
+**id** (`string`): Unique identifier for this filesystem instance. (Default: `Auto-generated`)
+
+**displayName** (`string`): Human-friendly display name for the UI.
+
+**icon** (`FilesystemIcon`): Icon identifier for the UI.
+
+**description** (`string`): Short description of this filesystem for the UI.
+
+**readOnly** (`boolean`): When true, all write operations are blocked. (Default: `false`)
+
+## Properties
+
+**id** (`string`): Filesystem instance identifier.
+
+**name** (`string`): Provider name ('AzureBlobFilesystem').
+
+**provider** (`string`): Provider identifier ('azure-blob').
+
+**readOnly** (`boolean | undefined`): Whether the filesystem is in read-only mode.
+
+## Methods
+
+AzureBlobFilesystem implements the [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem), providing all standard filesystem methods:
+
+- `readFile(path, options?)` - Read file contents
+- `writeFile(path, content, options?)` - Write content to a file
+- `appendFile(path, content)` - Append content to a file
+- `deleteFile(path, options?)` - Delete a file
+- `copyFile(src, dest, options?)` - Copy a file
+- `moveFile(src, dest, options?)` - Move or rename a file
+- `mkdir(path, options?)` - Create a directory
+- `rmdir(path, options?)` - Remove a directory
+- `readdir(path, options?)` - List directory contents
+- `exists(path)` - Check if a path exists
+- `stat(path)` - Get file or directory metadata
+
+### `init()`
+
+Initialize the filesystem. Verifies container access and credentials.
+
+```typescript
+await filesystem.init()
+```
+
+### `getInfo()`
+
+Returns metadata about this filesystem instance.
+
+```typescript
+const info = filesystem.getInfo()
+// { id: '...', name: 'AzureBlobFilesystem', provider: 'azure-blob', status: 'ready' }
+```
+
+### `getContainer()`
+
+Returns the underlying Azure Blob Storage `ContainerClient`.
+
+```typescript
+const container = await filesystem.getContainer()
+```
+
+### `getMountConfig()`
+
+Returns the mount configuration for sandbox providers that support Azure Blob filesystem mounts.
+
+```typescript
+const config = filesystem.getMountConfig()
+// { type: 'azure-blob', container: 'my-container', ... }
+```
+
+> **Note:** Azure Blob sandbox mounting depends on sandbox support for `azure-blob` mount configs. Use `filesystem` for direct workspace file operations when your sandbox provider does not support Azure Blob mounts.
+
+## Related
+
+- [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
+- [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
+- [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
+- [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/workspace/gcs-filesystem.md

@@ -190,5 +190,6 @@ See [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox) fo
 
 - [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
 - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
+- [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/workspace/s3-filesystem.md

@@ -193,5 +193,6 @@ See [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox) fo
 
 - [WorkspaceFilesystem interface](https://mastra.ai/reference/workspace/filesystem)
 - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
+- [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/reference/workspace/workspace-class.md

@@ -19,7 +19,7 @@ const workspace = new Workspace({
     workingDirectory: './workspace',
   }),
   bm25: true,
-  autoIndexPaths: ['/docs'],
+  autoIndexPaths: ['docs'],
 })
 ```
 

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @mastra/mcp-docs-server
 
+## 1.1.29-alpha.10
+
+### Patch Changes
+
+- Updated dependencies [[`28caa5b`](https://github.com/mastra-ai/mastra/commit/28caa5b032358545af2589ed90636eccb4dd9d2f), [`7d056b6`](https://github.com/mastra-ai/mastra/commit/7d056b6ecf603cacaa0f663ff1df025ed885b6c1), [`26f1f94`](https://github.com/mastra-ai/mastra/commit/26f1f9490574b864ba1ecedf2c9632e0767a23bd)]:
+  - @mastra/core@1.29.0-alpha.5
+
+## 1.1.29-alpha.9
+
+### Patch Changes
+
+- Updated dependencies [[`8a71261`](https://github.com/mastra-ai/mastra/commit/8a71261e3954ae617c6f8e25767b951f99438ab2), [`021a60f`](https://github.com/mastra-ai/mastra/commit/021a60f1f3e0135a70ef23c58be7a9b3aaffe6b4)]:
+  - @mastra/core@1.29.0-alpha.4
+
+## 1.1.29-alpha.7
+
+### Patch Changes
+
+- Updated dependencies [[`c04417b`](https://github.com/mastra-ai/mastra/commit/c04417ba0a2e4ded66da4352331ef29cd4bd1d79), [`cf25a03`](https://github.com/mastra-ai/mastra/commit/cf25a03132164b9dc1e5dccf7394824e33007c51), [`ba6b0c5`](https://github.com/mastra-ai/mastra/commit/ba6b0c51bfce358554fd33c7f2bcd5593633f2ff)]:
+  - @mastra/core@1.29.0-alpha.3
+
+## 1.1.29-alpha.5
+
+### Patch Changes
+
+- Updated dependencies [[`9e973b0`](https://github.com/mastra-ai/mastra/commit/9e973b010dacfa15ac82b0072897319f5234b90a), [`dd934a0`](https://github.com/mastra-ai/mastra/commit/dd934a0982ce0f78712fbd559e4f2410bf594b39), [`73f2809`](https://github.com/mastra-ai/mastra/commit/73f2809721db24e98cdf122539652a455211b450), [`aedeea4`](https://github.com/mastra-ai/mastra/commit/aedeea48a94f728323f040478775076b9574be50), [`8126d86`](https://github.com/mastra-ai/mastra/commit/8126d8638411eacfafdc29036ac998e8757ea66f), [`ae97520`](https://github.com/mastra-ai/mastra/commit/ae975206fdb0f6ef03c4d5bf94f7dc7c3f706c02), [`441670a`](https://github.com/mastra-ai/mastra/commit/441670a02c9dc7731c52674f55481e7848a84523)]:
+  - @mastra/core@1.29.0-alpha.2
+
+## 1.1.29-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`7a7b313`](https://github.com/mastra-ai/mastra/commit/7a7b3138fb3bcf0b0c740eaea07971e43d330ef3), [`a6dac0a`](https://github.com/mastra-ai/mastra/commit/a6dac0a40c7181161b1add4e8534f962bcbc9aa7), [`9cef83b`](https://github.com/mastra-ai/mastra/commit/9cef83b8a642b8098747772921e3523b492bafbc), [`d30e215`](https://github.com/mastra-ai/mastra/commit/d30e2156c746bc9fd791745cec1cc24377b66789), [`73b45fa`](https://github.com/mastra-ai/mastra/commit/73b45facdef4fbcb8af710c50f0646f18619dbaa), [`7a7b313`](https://github.com/mastra-ai/mastra/commit/7a7b3138fb3bcf0b0c740eaea07971e43d330ef3)]:
+  - @mastra/core@1.29.0-alpha.1
+
+## 1.1.29-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`b510d36`](https://github.com/mastra-ai/mastra/commit/b510d368f73dab6be2e2c2bc99035aaef1fb7d7a)]:
+  - @mastra/core@1.29.0-alpha.0
+
 ## 1.1.28
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.28",
+  "version": "1.1.29-alpha.11",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/mcp": "^1.5.2",
-    "@mastra/core": "1.28.0"
+    "@mastra/core": "1.29.0-alpha.5",
+    "@mastra/mcp": "^1.5.2"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -48,7 +48,7 @@
     "vitest": "4.1.5",
     "@internal/lint": "0.0.86",
     "@internal/types-builder": "0.0.61",
-    "@mastra/core": "1.28.0"
+    "@mastra/core": "1.29.0-alpha.5"
   },
   "homepage": "https://mastra.ai",
   "repository": {