@mastra/mcp-docs-server 0.13.17-alpha.3 → 0.13.17-alpha.5
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 +25 -0
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +19 -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 +26 -26
- package/.docs/organized/changelogs/%40mastra%2Fcloud.md +10 -10
- 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 +46 -46
- package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +19 -0
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +25 -25
- 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 +33 -33
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +19 -19
- 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 +10 -10
- package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +27 -27
- package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fmem0.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +24 -24
- 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 +19 -19
- package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +34 -34
- 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 +13 -0
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +25 -25
- 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 +19 -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 +19 -19
- 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 +31 -31
- package/.docs/organized/code-examples/a2a.md +1 -1
- package/.docs/organized/code-examples/agent-network.md +1 -1
- package/.docs/organized/code-examples/agent.md +22 -1
- package/.docs/organized/code-examples/agui.md +1 -1
- package/.docs/organized/code-examples/ai-sdk-useChat.md +1 -1
- package/.docs/organized/code-examples/ai-sdk-v5.md +2 -2
- package/.docs/organized/code-examples/assistant-ui.md +3 -3
- package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
- package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +1 -1
- package/.docs/organized/code-examples/bird-checker-with-nextjs.md +1 -1
- package/.docs/organized/code-examples/client-side-tools.md +1 -1
- package/.docs/organized/code-examples/crypto-chatbot.md +1 -1
- package/.docs/organized/code-examples/experimental-auth-weather-agent.md +1 -1
- package/.docs/organized/code-examples/fireworks-r1.md +1 -1
- package/.docs/organized/code-examples/heads-up-game.md +32 -56
- package/.docs/organized/code-examples/mcp-configuration.md +2 -2
- package/.docs/organized/code-examples/mcp-registry-registry.md +1 -1
- package/.docs/organized/code-examples/memory-with-mem0.md +1 -1
- package/.docs/organized/code-examples/memory-with-processors.md +1 -1
- package/.docs/organized/code-examples/openapi-spec-writer.md +2 -2
- package/.docs/organized/code-examples/quick-start.md +1 -1
- package/.docs/organized/code-examples/stock-price-tool.md +1 -1
- package/.docs/organized/code-examples/weather-agent.md +1 -1
- package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
- package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
- package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
- package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
- package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
- package/.docs/raw/agents/overview.mdx +35 -4
- package/.docs/raw/deployment/monorepo.mdx +1 -1
- package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +44 -14
- package/.docs/raw/getting-started/installation.mdx +52 -4
- package/.docs/raw/getting-started/templates.mdx +2 -22
- package/.docs/raw/reference/agents/generate.mdx +2 -2
- package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +2 -1
- package/.docs/raw/reference/agents/getDefaultVNextStreamOptions.mdx +1 -1
- package/.docs/raw/reference/agents/stream.mdx +2 -2
- package/.docs/raw/reference/cli/build.mdx +0 -6
- package/.docs/raw/reference/cli/start.mdx +8 -1
- package/.docs/raw/reference/scorers/noise-sensitivity.mdx +237 -0
- package/.docs/raw/reference/scorers/prompt-alignment.mdx +369 -0
- package/.docs/raw/scorers/off-the-shelf-scorers.mdx +2 -2
- package/.docs/raw/streaming/overview.mdx +2 -2
- package/.docs/raw/streaming/tool-streaming.mdx +8 -2
- package/.docs/raw/streaming/workflow-streaming.mdx +8 -2
- package/.docs/raw/tools-mcp/overview.mdx +44 -0
- package/.docs/raw/workflows/overview.mdx +19 -17
- package/.docs/raw/workflows/suspend-and-resume.mdx +64 -7
- package/CHANGELOG.md +1813 -0
- package/dist/stdio.js +18 -1
- package/dist/tools/blog.d.ts.map +1 -1
- package/dist/tools/docs.d.ts.map +1 -1
- package/package.json +17 -7
package/dist/stdio.js
CHANGED
|
@@ -94,8 +94,21 @@ async function fetchBlogPosts() {
|
|
|
94
94
|
}).filter(Boolean);
|
|
95
95
|
return "Mastra.ai Blog Posts:\n\n" + blogLinks.join("\n");
|
|
96
96
|
}
|
|
97
|
+
function validateBlogUrl(url) {
|
|
98
|
+
try {
|
|
99
|
+
const inputUrl = new URL(url);
|
|
100
|
+
const baseUrl = new URL(BLOG_BASE_URL);
|
|
101
|
+
return inputUrl.hostname === baseUrl.hostname;
|
|
102
|
+
} catch {
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
}
|
|
97
106
|
async function fetchBlogPost(url) {
|
|
98
107
|
void logger.debug(`Fetching blog post: ${url}`);
|
|
108
|
+
if (!validateBlogUrl(url)) {
|
|
109
|
+
void logger.error(`Rejected request to unauthorized domain: ${url}`);
|
|
110
|
+
return `URL must be from the same domain as ${BLOG_BASE_URL}`;
|
|
111
|
+
}
|
|
99
112
|
const response = await fetch(url);
|
|
100
113
|
if (!response.ok) {
|
|
101
114
|
if (response.status === 429) {
|
|
@@ -798,7 +811,11 @@ async function listDirContents(dirPath) {
|
|
|
798
811
|
}
|
|
799
812
|
}
|
|
800
813
|
async function readMdxContent(docPath, queryKeywords) {
|
|
801
|
-
const fullPath = path3__default.join(docsBaseDir, docPath);
|
|
814
|
+
const fullPath = path3__default.resolve(path3__default.join(docsBaseDir, docPath));
|
|
815
|
+
if (!fullPath.startsWith(path3__default.resolve(docsBaseDir))) {
|
|
816
|
+
void logger.error(`Path traversal attempt detected`);
|
|
817
|
+
return { found: false };
|
|
818
|
+
}
|
|
802
819
|
void logger.debug(`Reading MDX content from: ${fullPath}`);
|
|
803
820
|
try {
|
|
804
821
|
const stats = await fs3.stat(fullPath);
|
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/dist/tools/docs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgKxB,eAAO,MAAM,eAAe;;;;;;;;;EAW1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;oBAkBG,SAAS;CAiDhC,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.5",
|
|
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
|
".": {
|
|
@@ -30,10 +31,10 @@
|
|
|
30
31
|
"jsdom": "^26.1.0",
|
|
31
32
|
"turndown": "^7.2.0",
|
|
32
33
|
"uuid": "^11.1.0",
|
|
33
|
-
"zod": "^3.25.
|
|
34
|
-
"zod-to-json-schema": "^3.24.
|
|
35
|
-
"@mastra/core": "0.15.3-alpha.
|
|
36
|
-
"@mastra/mcp": "^0.11.3-alpha.
|
|
34
|
+
"zod": "^3.25.76",
|
|
35
|
+
"zod-to-json-schema": "^3.24.6",
|
|
36
|
+
"@mastra/core": "0.15.3-alpha.5",
|
|
37
|
+
"@mastra/mcp": "^0.11.3-alpha.2"
|
|
37
38
|
},
|
|
38
39
|
"devDependencies": {
|
|
39
40
|
"@hono/node-server": "^1.17.1",
|
|
@@ -48,9 +49,18 @@
|
|
|
48
49
|
"tsx": "^4.19.4",
|
|
49
50
|
"typescript": "^5.8.3",
|
|
50
51
|
"vitest": "^3.2.4",
|
|
51
|
-
"@mastra/core": "0.15.3-alpha.
|
|
52
|
+
"@mastra/core": "0.15.3-alpha.5",
|
|
52
53
|
"@internal/lint": "0.0.34"
|
|
53
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"
|
|
63
|
+
},
|
|
54
64
|
"scripts": {
|
|
55
65
|
"prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",
|
|
56
66
|
"build:cli": "tsup src/stdio.ts src/prepare-docs/prepare.ts --format esm --no-dts --treeshake=smallest --splitting && tsc -p tsconfig.build.json",
|