@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.
Files changed (76) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +20 -0
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +9 -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 +17 -17
  8. package/.docs/organized/changelogs/%40mastra%2Fcloud.md +21 -21
  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 +39 -39
  12. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +10 -10
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +21 -0
  14. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +15 -15
  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 +24 -24
  18. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
  19. package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
  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 +19 -19
  25. package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
  26. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +23 -23
  27. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +10 -10
  28. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +23 -23
  29. package/.docs/organized/changelogs/%40mastra%2Fmem0.md +19 -19
  30. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +21 -21
  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 +10 -10
  35. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
  36. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +24 -24
  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 +12 -0
  41. package/.docs/organized/changelogs/%40mastra%2Fserver.md +20 -20
  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 +9 -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 +10 -10
  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 +26 -26
  60. package/.docs/organized/code-examples/assistant-ui.md +1 -1
  61. package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +2 -2
  62. package/.docs/organized/code-examples/heads-up-game.md +32 -56
  63. package/.docs/raw/getting-started/installation.mdx +2 -7
  64. package/.docs/raw/getting-started/templates.mdx +2 -7
  65. package/.docs/raw/memory/working-memory.mdx +17 -17
  66. package/.docs/raw/observability/ai-tracing.mdx +438 -0
  67. package/.docs/raw/reference/scorers/noise-sensitivity.mdx +87 -20
  68. package/.docs/raw/reference/tools/mcp-server.mdx +26 -27
  69. package/.docs/raw/tools-mcp/mcp-overview.mdx +6 -5
  70. package/.docs/raw/workflows/suspend-and-resume.mdx +64 -7
  71. package/CHANGELOG.md +1823 -0
  72. package/dist/logger.d.ts +5 -1
  73. package/dist/logger.d.ts.map +1 -1
  74. package/dist/stdio.js +47 -4
  75. package/dist/tools/blog.d.ts.map +1 -1
  76. 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
- debug: (message: string, data?: any) => Promise<void>;
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;
@@ -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;AAG7C,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,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,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,GAAG,SA2BxD,CAAC;AAGF,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAoDvD;AAGD,eAAO,MAAM,MAAM,QAAiB,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
- debug: async (message, data) => {
68
- if (process.env.DEBUG || process.env.NODE_ENV === "development") {
69
- await sendLog("debug", message, data);
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) {
@@ -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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "0.13.17-alpha.4",
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.4",
36
- "@mastra/mcp": "^0.11.3-alpha.1"
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
- "@mastra/core": "0.15.3-alpha.4",
52
- "@internal/lint": "0.0.34"
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",