@mastra/mcp-docs-server 0.13.17-alpha.4 → 0.13.17-alpha.6
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/organized/changelogs/%40mastra%2Fagent-builder.md +20 -0
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +9 -0
- package/.docs/organized/changelogs/%40mastra%2Fastra.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fauth.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Fchroma.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +17 -17
- package/.docs/organized/changelogs/%40mastra%2Fcloud.md +21 -21
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +39 -39
- package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +21 -0
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +15 -15
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +12 -12
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +24 -24
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Ffirecrawl.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fgithub.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Flance.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +23 -23
- package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +23 -23
- package/.docs/organized/changelogs/%40mastra%2Fmem0.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +21 -21
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +10 -5
- package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +24 -24
- package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +13 -13
- package/.docs/organized/changelogs/%40mastra%2Frag.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fragie.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +12 -0
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +9 -0
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +9 -0
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +10 -10
- package/.docs/organized/changelogs/create-mastra.md +13 -13
- package/.docs/organized/changelogs/mastra.md +26 -26
- package/.docs/organized/code-examples/assistant-ui.md +1 -1
- package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +2 -2
- package/.docs/organized/code-examples/heads-up-game.md +32 -56
- package/.docs/raw/getting-started/installation.mdx +2 -7
- package/.docs/raw/getting-started/templates.mdx +2 -7
- package/.docs/raw/memory/working-memory.mdx +17 -17
- package/.docs/raw/observability/ai-tracing.mdx +438 -0
- package/.docs/raw/reference/scorers/noise-sensitivity.mdx +87 -20
- package/.docs/raw/reference/tools/mcp-server.mdx +26 -27
- package/.docs/raw/tools-mcp/mcp-overview.mdx +6 -5
- package/.docs/raw/workflows/suspend-and-resume.mdx +64 -7
- package/CHANGELOG.md +1823 -0
- package/dist/logger.d.ts +5 -1
- package/dist/logger.d.ts.map +1 -1
- package/dist/stdio.js +47 -4
- package/dist/tools/blog.d.ts.map +1 -1
- package/package.json +16 -6
package/dist/logger.d.ts
CHANGED
|
@@ -1,9 +1,13 @@
|
|
|
1
1
|
import type { MCPServer } from '@mastra/mcp';
|
|
2
2
|
export interface Logger {
|
|
3
|
+
debug: (message: string, data?: any) => Promise<void>;
|
|
3
4
|
info: (message: string, data?: any) => Promise<void>;
|
|
5
|
+
notice: (message: string, data?: any) => Promise<void>;
|
|
4
6
|
warning: (message: string, data?: any) => Promise<void>;
|
|
5
7
|
error: (message: string, error?: any) => Promise<void>;
|
|
6
|
-
|
|
8
|
+
critical: (message: string, error?: any) => Promise<void>;
|
|
9
|
+
alert: (message: string, error?: any) => Promise<void>;
|
|
10
|
+
emergency: (message: string, error?: any) => Promise<void>;
|
|
7
11
|
}
|
|
8
12
|
export declare const writeErrorLog: (message: string, data?: any) => void;
|
|
9
13
|
export declare function createLogger(server?: MCPServer): Logger;
|
package/dist/logger.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SA2BxD,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CA2FvD;AAGD,eAAO,MAAM,MAAM,QAAiB,CAAC"}
|
package/dist/stdio.js
CHANGED
|
@@ -49,9 +49,17 @@ function createLogger(server2) {
|
|
|
49
49
|
}
|
|
50
50
|
};
|
|
51
51
|
return {
|
|
52
|
+
debug: async (message, data) => {
|
|
53
|
+
if (process.env.DEBUG || process.env.NODE_ENV === "development") {
|
|
54
|
+
await sendLog("debug", message, data);
|
|
55
|
+
}
|
|
56
|
+
},
|
|
52
57
|
info: async (message, data) => {
|
|
53
58
|
await sendLog("info", message, data);
|
|
54
59
|
},
|
|
60
|
+
notice: async (message, data) => {
|
|
61
|
+
await sendLog("notice", message, data);
|
|
62
|
+
},
|
|
55
63
|
warning: async (message, data) => {
|
|
56
64
|
await sendLog("warning", message, data);
|
|
57
65
|
},
|
|
@@ -64,10 +72,32 @@ function createLogger(server2) {
|
|
|
64
72
|
writeErrorLog(message, errorData);
|
|
65
73
|
await sendLog("error", message, errorData);
|
|
66
74
|
},
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
75
|
+
critical: async (message, error) => {
|
|
76
|
+
const errorData = error instanceof Error ? {
|
|
77
|
+
message: error.message,
|
|
78
|
+
stack: error.stack,
|
|
79
|
+
name: error.name
|
|
80
|
+
} : error;
|
|
81
|
+
writeErrorLog(message, errorData);
|
|
82
|
+
await sendLog("critical", message, errorData);
|
|
83
|
+
},
|
|
84
|
+
alert: async (message, error) => {
|
|
85
|
+
const errorData = error instanceof Error ? {
|
|
86
|
+
message: error.message,
|
|
87
|
+
stack: error.stack,
|
|
88
|
+
name: error.name
|
|
89
|
+
} : error;
|
|
90
|
+
writeErrorLog(message, errorData);
|
|
91
|
+
await sendLog("alert", message, errorData);
|
|
92
|
+
},
|
|
93
|
+
emergency: async (message, error) => {
|
|
94
|
+
const errorData = error instanceof Error ? {
|
|
95
|
+
message: error.message,
|
|
96
|
+
stack: error.stack,
|
|
97
|
+
name: error.name
|
|
98
|
+
} : error;
|
|
99
|
+
writeErrorLog(message, errorData);
|
|
100
|
+
await sendLog("emergency", message, errorData);
|
|
71
101
|
}
|
|
72
102
|
};
|
|
73
103
|
}
|
|
@@ -94,8 +124,21 @@ async function fetchBlogPosts() {
|
|
|
94
124
|
}).filter(Boolean);
|
|
95
125
|
return "Mastra.ai Blog Posts:\n\n" + blogLinks.join("\n");
|
|
96
126
|
}
|
|
127
|
+
function validateBlogUrl(url) {
|
|
128
|
+
try {
|
|
129
|
+
const inputUrl = new URL(url);
|
|
130
|
+
const baseUrl = new URL(BLOG_BASE_URL);
|
|
131
|
+
return inputUrl.hostname === baseUrl.hostname;
|
|
132
|
+
} catch {
|
|
133
|
+
return false;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
97
136
|
async function fetchBlogPost(url) {
|
|
98
137
|
void logger.debug(`Fetching blog post: ${url}`);
|
|
138
|
+
if (!validateBlogUrl(url)) {
|
|
139
|
+
void logger.error(`Rejected request to unauthorized domain: ${url}`);
|
|
140
|
+
return `URL must be from the same domain as ${BLOG_BASE_URL}`;
|
|
141
|
+
}
|
|
99
142
|
const response = await fetch(url);
|
|
100
143
|
if (!response.ok) {
|
|
101
144
|
if (response.status === 429) {
|
package/dist/tools/blog.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/tools/blog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../../src/tools/blog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8FxB,eAAO,MAAM,eAAe;;;;;;EAM1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ;;;;;;;;;;oBAKG,SAAS;CAehC,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "0.13.17-alpha.
|
|
3
|
+
"version": "0.13.17-alpha.6",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -9,7 +9,8 @@
|
|
|
9
9
|
"files": [
|
|
10
10
|
"dist",
|
|
11
11
|
".docs",
|
|
12
|
-
"README.md"
|
|
12
|
+
"README.md",
|
|
13
|
+
"CHANGELOG.md"
|
|
13
14
|
],
|
|
14
15
|
"exports": {
|
|
15
16
|
".": {
|
|
@@ -32,8 +33,8 @@
|
|
|
32
33
|
"uuid": "^11.1.0",
|
|
33
34
|
"zod": "^3.25.76",
|
|
34
35
|
"zod-to-json-schema": "^3.24.6",
|
|
35
|
-
"@mastra/core": "0.15.3-alpha.
|
|
36
|
-
"@mastra/mcp": "^0.11.3-alpha.
|
|
36
|
+
"@mastra/core": "0.15.3-alpha.6",
|
|
37
|
+
"@mastra/mcp": "^0.11.3-alpha.3"
|
|
37
38
|
},
|
|
38
39
|
"devDependencies": {
|
|
39
40
|
"@hono/node-server": "^1.17.1",
|
|
@@ -48,8 +49,17 @@
|
|
|
48
49
|
"tsx": "^4.19.4",
|
|
49
50
|
"typescript": "^5.8.3",
|
|
50
51
|
"vitest": "^3.2.4",
|
|
51
|
-
"@
|
|
52
|
-
"@
|
|
52
|
+
"@internal/lint": "0.0.34",
|
|
53
|
+
"@mastra/core": "0.15.3-alpha.6"
|
|
54
|
+
},
|
|
55
|
+
"homepage": "https://mastra.ai",
|
|
56
|
+
"repository": {
|
|
57
|
+
"type": "git",
|
|
58
|
+
"url": "git+https://github.com/mastra-ai/mastra.git",
|
|
59
|
+
"directory": "packages/mcp-docs-server"
|
|
60
|
+
},
|
|
61
|
+
"bugs": {
|
|
62
|
+
"url": "https://github.com/mastra-ai/mastra/issues"
|
|
53
63
|
},
|
|
54
64
|
"scripts": {
|
|
55
65
|
"prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",
|