@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.
Files changed (112) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +25 -0
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +19 -0
  3. package/.docs/organized/changelogs/%40mastra%2Fastra.md +10 -10
  4. package/.docs/organized/changelogs/%40mastra%2Fauth.md +6 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +10 -10
  6. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +10 -10
  7. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +26 -26
  8. package/.docs/organized/changelogs/%40mastra%2Fcloud.md +10 -10
  9. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +10 -10
  10. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +11 -11
  11. package/.docs/organized/changelogs/%40mastra%2Fcore.md +46 -46
  12. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +10 -10
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +19 -0
  14. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +25 -25
  15. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +11 -11
  16. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +12 -12
  17. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +33 -33
  18. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
  19. package/.docs/organized/changelogs/%40mastra%2Fevals.md +19 -19
  20. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  21. package/.docs/organized/changelogs/%40mastra%2Ffirecrawl.md +20 -20
  22. package/.docs/organized/changelogs/%40mastra%2Fgithub.md +19 -19
  23. package/.docs/organized/changelogs/%40mastra%2Flance.md +10 -10
  24. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +10 -10
  25. package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
  26. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +27 -27
  27. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +20 -20
  28. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +19 -19
  29. package/.docs/organized/changelogs/%40mastra%2Fmem0.md +10 -10
  30. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +24 -24
  31. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +11 -11
  32. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +10 -5
  33. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +10 -10
  34. package/.docs/organized/changelogs/%40mastra%2Fpg.md +19 -19
  35. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
  36. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +34 -34
  37. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +13 -13
  38. package/.docs/organized/changelogs/%40mastra%2Frag.md +10 -10
  39. package/.docs/organized/changelogs/%40mastra%2Fragie.md +19 -19
  40. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +13 -0
  41. package/.docs/organized/changelogs/%40mastra%2Fserver.md +25 -25
  42. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +11 -11
  43. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +10 -10
  44. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +10 -10
  45. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +10 -10
  46. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +10 -10
  47. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +10 -10
  48. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +10 -10
  49. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +9 -0
  50. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +19 -0
  51. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +10 -10
  52. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +10 -10
  53. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +19 -19
  54. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +10 -10
  55. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +11 -11
  56. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +11 -11
  57. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +10 -10
  58. package/.docs/organized/changelogs/create-mastra.md +13 -13
  59. package/.docs/organized/changelogs/mastra.md +31 -31
  60. package/.docs/organized/code-examples/a2a.md +1 -1
  61. package/.docs/organized/code-examples/agent-network.md +1 -1
  62. package/.docs/organized/code-examples/agent.md +22 -1
  63. package/.docs/organized/code-examples/agui.md +1 -1
  64. package/.docs/organized/code-examples/ai-sdk-useChat.md +1 -1
  65. package/.docs/organized/code-examples/ai-sdk-v5.md +2 -2
  66. package/.docs/organized/code-examples/assistant-ui.md +3 -3
  67. package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
  68. package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +1 -1
  69. package/.docs/organized/code-examples/bird-checker-with-nextjs.md +1 -1
  70. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  71. package/.docs/organized/code-examples/crypto-chatbot.md +1 -1
  72. package/.docs/organized/code-examples/experimental-auth-weather-agent.md +1 -1
  73. package/.docs/organized/code-examples/fireworks-r1.md +1 -1
  74. package/.docs/organized/code-examples/heads-up-game.md +32 -56
  75. package/.docs/organized/code-examples/mcp-configuration.md +2 -2
  76. package/.docs/organized/code-examples/mcp-registry-registry.md +1 -1
  77. package/.docs/organized/code-examples/memory-with-mem0.md +1 -1
  78. package/.docs/organized/code-examples/memory-with-processors.md +1 -1
  79. package/.docs/organized/code-examples/openapi-spec-writer.md +2 -2
  80. package/.docs/organized/code-examples/quick-start.md +1 -1
  81. package/.docs/organized/code-examples/stock-price-tool.md +1 -1
  82. package/.docs/organized/code-examples/weather-agent.md +1 -1
  83. package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
  84. package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
  85. package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
  86. package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
  87. package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
  88. package/.docs/raw/agents/overview.mdx +35 -4
  89. package/.docs/raw/deployment/monorepo.mdx +1 -1
  90. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +44 -14
  91. package/.docs/raw/getting-started/installation.mdx +52 -4
  92. package/.docs/raw/getting-started/templates.mdx +2 -22
  93. package/.docs/raw/reference/agents/generate.mdx +2 -2
  94. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +2 -1
  95. package/.docs/raw/reference/agents/getDefaultVNextStreamOptions.mdx +1 -1
  96. package/.docs/raw/reference/agents/stream.mdx +2 -2
  97. package/.docs/raw/reference/cli/build.mdx +0 -6
  98. package/.docs/raw/reference/cli/start.mdx +8 -1
  99. package/.docs/raw/reference/scorers/noise-sensitivity.mdx +237 -0
  100. package/.docs/raw/reference/scorers/prompt-alignment.mdx +369 -0
  101. package/.docs/raw/scorers/off-the-shelf-scorers.mdx +2 -2
  102. package/.docs/raw/streaming/overview.mdx +2 -2
  103. package/.docs/raw/streaming/tool-streaming.mdx +8 -2
  104. package/.docs/raw/streaming/workflow-streaming.mdx +8 -2
  105. package/.docs/raw/tools-mcp/overview.mdx +44 -0
  106. package/.docs/raw/workflows/overview.mdx +19 -17
  107. package/.docs/raw/workflows/suspend-and-resume.mdx +64 -7
  108. package/CHANGELOG.md +1813 -0
  109. package/dist/stdio.js +18 -1
  110. package/dist/tools/blog.d.ts.map +1 -1
  111. package/dist/tools/docs.d.ts.map +1 -1
  112. 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);
@@ -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;AAyExB,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"}
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"}
@@ -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;AA4JxB,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"}
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",
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.67",
34
- "zod-to-json-schema": "^3.24.5",
35
- "@mastra/core": "0.15.3-alpha.3",
36
- "@mastra/mcp": "^0.11.3-alpha.0"
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.3",
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",