@mastra/mcp-docs-server 1.1.22-alpha.6 → 1.1.22-alpha.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.docs/reference/templates/overview.md +88 -14
- package/CHANGELOG.md +7 -0
- package/package.json +5 -5
|
@@ -4,10 +4,10 @@ This reference provides comprehensive information about Mastra templates, includ
|
|
|
4
4
|
|
|
5
5
|
Mastra templates are pre-built project structures that demonstrate specific use cases and patterns. They provide:
|
|
6
6
|
|
|
7
|
-
- **Working examples
|
|
8
|
-
- **Best practices
|
|
9
|
-
- **Educational resources
|
|
10
|
-
- **Quickstarts
|
|
7
|
+
- **Working examples**: Complete, functional Mastra applications
|
|
8
|
+
- **Best practices**: Proper project structure and coding conventions
|
|
9
|
+
- **Educational resources**: Learn Mastra patterns through real implementations
|
|
10
|
+
- **Quickstarts**: Bootstrap projects faster than building from scratch
|
|
11
11
|
|
|
12
12
|
## Using templates
|
|
13
13
|
|
|
@@ -15,10 +15,30 @@ Mastra templates are pre-built project structures that demonstrate specific use
|
|
|
15
15
|
|
|
16
16
|
Install a template using the `create-mastra` command:
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
**npm**:
|
|
19
|
+
|
|
20
|
+
```sh
|
|
19
21
|
npx create-mastra@latest --template template-name
|
|
20
22
|
```
|
|
21
23
|
|
|
24
|
+
**pnpm**:
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
pnpm dlx create-mastra@latest --template template-name
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**Yarn**:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
yarn dlx create-mastra@latest --template template-name
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Bun**:
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
bun x create-mastra@latest --template template-name
|
|
40
|
+
```
|
|
41
|
+
|
|
22
42
|
This creates a complete project with all necessary code and configuration.
|
|
23
43
|
|
|
24
44
|
### Setup Process
|
|
@@ -41,20 +61,74 @@ After installation:
|
|
|
41
61
|
|
|
42
62
|
3. **Install dependencies** (if not done automatically):
|
|
43
63
|
|
|
44
|
-
|
|
64
|
+
**npm**:
|
|
65
|
+
|
|
66
|
+
```sh
|
|
45
67
|
npm install
|
|
46
68
|
```
|
|
47
69
|
|
|
70
|
+
**pnpm**:
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
pnpm install
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
**Yarn**:
|
|
77
|
+
|
|
78
|
+
```sh
|
|
79
|
+
yarn install
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
**Bun**:
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
bun install
|
|
86
|
+
```
|
|
87
|
+
|
|
48
88
|
4. **Start development server**:
|
|
49
89
|
|
|
50
|
-
|
|
90
|
+
**npm**:
|
|
91
|
+
|
|
92
|
+
```sh
|
|
51
93
|
npm run dev
|
|
52
94
|
```
|
|
53
95
|
|
|
54
|
-
|
|
96
|
+
**pnpm**:
|
|
97
|
+
|
|
98
|
+
```sh
|
|
99
|
+
pnpm run dev
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
**Yarn**:
|
|
103
|
+
|
|
104
|
+
```sh
|
|
105
|
+
yarn dev
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Bun**:
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
bun run dev
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### Template structure
|
|
55
115
|
|
|
56
116
|
All templates follow this standardized structure:
|
|
57
117
|
|
|
118
|
+
```text
|
|
119
|
+
your-template/
|
|
120
|
+
├── src/
|
|
121
|
+
│ └── mastra/
|
|
122
|
+
│ ├── agents/ # Agent definitions
|
|
123
|
+
│ ├── tools/ # Tool definitions
|
|
124
|
+
│ ├── workflows/ # Workflow definitions
|
|
125
|
+
│ └── index.ts # Main Mastra config
|
|
126
|
+
├── .env.example # Required environment variables
|
|
127
|
+
├── package.json
|
|
128
|
+
├── tsconfig.json
|
|
129
|
+
└── README.md
|
|
130
|
+
```
|
|
131
|
+
|
|
58
132
|
## Creating templates
|
|
59
133
|
|
|
60
134
|
### Requirements
|
|
@@ -127,12 +201,12 @@ const agent = new Agent({
|
|
|
127
201
|
|
|
128
202
|
Templates must be:
|
|
129
203
|
|
|
130
|
-
- **Single projects
|
|
131
|
-
- **Framework-free
|
|
132
|
-
- **Mastra-focused
|
|
133
|
-
- **Mergeable
|
|
134
|
-
- **Node.js compatible
|
|
135
|
-
- **ESM modules
|
|
204
|
+
- **Single projects**: Not monorepos with multiple applications
|
|
205
|
+
- **Framework-free**: No Next.js, Express, or other web framework boilerplate
|
|
206
|
+
- **Mastra-focused**: Demonstrate Mastra functionality without additional layers
|
|
207
|
+
- **Mergeable**: Structure code for seamless integration into existing projects
|
|
208
|
+
- **Node.js compatible**: Support Node.js v22.13.0 and later
|
|
209
|
+
- **ESM modules**: Use ES modules (`"type": "module"` in package.json)
|
|
136
210
|
|
|
137
211
|
### Documentation Requirements
|
|
138
212
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.1.22-alpha.7
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`1371703`](https://github.com/mastra-ai/mastra/commit/1371703835080450ef3f9aea58059a95d0da2e5a), [`98f8a8b`](https://github.com/mastra-ai/mastra/commit/98f8a8bdf5761b9982f3ad3acbe7f1cc3efa71f3)]:
|
|
8
|
+
- @mastra/core@1.23.0-alpha.5
|
|
9
|
+
|
|
3
10
|
## 1.1.22-alpha.5
|
|
4
11
|
|
|
5
12
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.1.22-alpha.
|
|
3
|
+
"version": "1.1.22-alpha.7",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -29,8 +29,8 @@
|
|
|
29
29
|
"jsdom": "^26.1.0",
|
|
30
30
|
"local-pkg": "^1.1.2",
|
|
31
31
|
"zod": "^4.3.6",
|
|
32
|
-
"@mastra/
|
|
33
|
-
"@mastra/
|
|
32
|
+
"@mastra/mcp": "^1.4.1",
|
|
33
|
+
"@mastra/core": "1.23.0-alpha.5"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
36
36
|
"@hono/node-server": "^1.19.11",
|
|
@@ -46,9 +46,9 @@
|
|
|
46
46
|
"tsx": "^4.21.0",
|
|
47
47
|
"typescript": "^5.9.3",
|
|
48
48
|
"vitest": "4.0.18",
|
|
49
|
-
"@internal/types-builder": "0.0.54",
|
|
50
49
|
"@internal/lint": "0.0.79",
|
|
51
|
-
"@
|
|
50
|
+
"@internal/types-builder": "0.0.54",
|
|
51
|
+
"@mastra/core": "1.23.0-alpha.5"
|
|
52
52
|
},
|
|
53
53
|
"homepage": "https://mastra.ai",
|
|
54
54
|
"repository": {
|