@mastra/mcp 0.11.4 → 0.12.0-alpha.0
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/CHANGELOG.md +13 -0
- package/dist/index.cjs +6 -57
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +8 -58
- package/dist/index.js.map +1 -1
- package/dist/server/server.d.ts +5 -5
- package/dist/server/server.d.ts.map +1 -1
- package/dist/server/types.d.ts +1 -62
- package/dist/server/types.d.ts.map +1 -1
- package/package.json +4 -4
package/dist/server/server.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type * as http from 'node:http';
|
|
2
|
-
import type {
|
|
2
|
+
import type { ToolsInput, Agent } from '@mastra/core/agent';
|
|
3
3
|
import { MCPServerBase } from '@mastra/core/mcp';
|
|
4
|
-
import type { ServerInfo, ServerDetailInfo, ConvertedTool, MCPServerHonoSSEOptions, MCPServerSSEOptions, MCPToolType } from '@mastra/core/mcp';
|
|
4
|
+
import type { MCPServerConfig, ServerInfo, ServerDetailInfo, ConvertedTool, MCPServerHonoSSEOptions, MCPServerSSEOptions, MCPToolType } from '@mastra/core/mcp';
|
|
5
5
|
import type { Workflow } from '@mastra/core/workflows';
|
|
6
6
|
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
|
7
7
|
import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
|
|
@@ -11,7 +11,7 @@ import type { SSEStreamingApi } from 'hono/streaming';
|
|
|
11
11
|
import { SSETransport } from 'hono-mcp-server-sse-transport';
|
|
12
12
|
import { ServerPromptActions } from './promptActions.js';
|
|
13
13
|
import { ServerResourceActions } from './resourceActions.js';
|
|
14
|
-
import type { MCPServerPrompts, MCPServerResources, ElicitationActions
|
|
14
|
+
import type { MCPServerPrompts, MCPServerResources, ElicitationActions } from './types.js';
|
|
15
15
|
export declare class MCPServer extends MCPServerBase {
|
|
16
16
|
private server;
|
|
17
17
|
private stdioTransport?;
|
|
@@ -85,12 +85,12 @@ export declare class MCPServer extends MCPServerBase {
|
|
|
85
85
|
/**
|
|
86
86
|
* Convert and validate all provided tools, logging registration status.
|
|
87
87
|
* Also converts agents and workflows into tools.
|
|
88
|
-
* @param tools Tool definitions
|
|
88
|
+
* @param tools Tool definitions
|
|
89
89
|
* @param agentsConfig Agent definitions to be converted to tools, expected from MCPServerConfig
|
|
90
90
|
* @param workflowsConfig Workflow definitions to be converted to tools, expected from MCPServerConfig
|
|
91
91
|
* @returns Converted tools registry
|
|
92
92
|
*/
|
|
93
|
-
convertTools(tools: ToolsInput
|
|
93
|
+
convertTools(tools: ToolsInput, agentsConfig?: Record<string, Agent>, workflowsConfig?: Record<string, Workflow>): Record<string, ConvertedTool>;
|
|
94
94
|
/**
|
|
95
95
|
* Start the MCP server using stdio transport (for Windsurf integration).
|
|
96
96
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"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"}
|
package/dist/server/types.d.ts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type { InternalCoreTool, ToolAction, VercelTool, VercelToolV5 } from '@mastra/core/tools';
|
|
1
|
+
import type { InternalCoreTool } from '@mastra/core/tools';
|
|
3
2
|
import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
|
|
4
3
|
import type { ElicitRequest, ElicitResult, Prompt, PromptMessage, Resource, ResourceTemplate } from '@modelcontextprotocol/sdk/types.js';
|
|
5
4
|
import type { z } from 'zod';
|
|
@@ -41,65 +40,5 @@ export type MCPTool<TSchemaIn extends z.ZodSchema | undefined = undefined, TSche
|
|
|
41
40
|
extra: MCPRequestHandlerExtra;
|
|
42
41
|
}) => Promise<any>;
|
|
43
42
|
};
|
|
44
|
-
/**
|
|
45
|
-
* Enhanced execute options for MCP tools that includes elicitation and extra context
|
|
46
|
-
*/
|
|
47
|
-
export interface MCPToolExecuteOptions<TSchemaIn extends z.ZodSchema | undefined = undefined> {
|
|
48
|
-
context: TSchemaIn extends z.ZodSchema ? z.infer<TSchemaIn> : any;
|
|
49
|
-
elicitation: ElicitationActions;
|
|
50
|
-
extra: MCPRequestHandlerExtra;
|
|
51
|
-
}
|
|
52
|
-
/**
|
|
53
|
-
* Action interface for MCP tools
|
|
54
|
-
*/
|
|
55
|
-
export interface MCPToolAction<TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined> {
|
|
56
|
-
id: string;
|
|
57
|
-
description: string;
|
|
58
|
-
inputSchema?: TSchemaIn;
|
|
59
|
-
outputSchema?: TSchemaOut;
|
|
60
|
-
execute: (params: TSchemaIn extends z.ZodSchema ? z.infer<TSchemaIn> : any, options: MCPToolExecuteOptions<TSchemaIn>) => Promise<TSchemaOut extends z.ZodSchema ? z.infer<TSchemaOut> : any>;
|
|
61
|
-
}
|
|
62
|
-
/**
|
|
63
|
-
* Creates an MCP tool with proper typing for the MCP server environment.
|
|
64
|
-
* Similar to createTool but specifically designed for MCP tools with elicitation support.
|
|
65
|
-
*
|
|
66
|
-
* @param opts Tool action configuration
|
|
67
|
-
* @returns MCPTool instance
|
|
68
|
-
*
|
|
69
|
-
* @example
|
|
70
|
-
* ```typescript
|
|
71
|
-
* const mcpTool = createMCPTool({
|
|
72
|
-
* id: 'weather',
|
|
73
|
-
* description: 'Get weather information',
|
|
74
|
-
* inputSchema: z.object({
|
|
75
|
-
* city: z.string(),
|
|
76
|
-
* }),
|
|
77
|
-
* outputSchema: z.object({
|
|
78
|
-
* temperature: z.number(),
|
|
79
|
-
* condition: z.string(),
|
|
80
|
-
* }),
|
|
81
|
-
* execute: async (params, { context, elicitation, extra }) => {
|
|
82
|
-
* // params contains the validated input: { city: string }
|
|
83
|
-
* // context is the same as params for convenience
|
|
84
|
-
* // Can use elicitation.sendRequest() for interactive prompts
|
|
85
|
-
* // Access extra MCP context via extra parameter
|
|
86
|
-
* return { temperature: 72, condition: 'sunny' };
|
|
87
|
-
* },
|
|
88
|
-
* });
|
|
89
|
-
* ```
|
|
90
|
-
*/
|
|
91
|
-
export declare function createMCPTool<TSchemaIn extends z.ZodSchema | undefined = undefined, TSchemaOut extends z.ZodSchema | undefined = undefined>(opts: MCPToolAction<TSchemaIn, TSchemaOut>): MCPTool;
|
|
92
|
-
/**
|
|
93
|
-
* MCP-specific tools input that supports MCPToolAction and MCPTool types in addition to regular tools
|
|
94
|
-
*/
|
|
95
|
-
export type MCPToolsInput = Record<string, ToolAction<any, any, any> | VercelTool | VercelToolV5 | MCPToolAction<any, any> | MCPTool>;
|
|
96
|
-
/**
|
|
97
|
-
* Enhanced MCPServerConfig that supports MCP-specific tool types.
|
|
98
|
-
* This overrides the base MCPServerConfig from @mastra/core/mcp to accept our enhanced tool types.
|
|
99
|
-
*/
|
|
100
|
-
export interface MCPServerConfig extends Omit<BaseMCPServerConfig, 'tools'> {
|
|
101
|
-
/** The tools that this MCP server will expose. Supports regular tools, MCP tool actions, or MCP tools. */
|
|
102
|
-
tools: MCPToolsInput;
|
|
103
|
-
}
|
|
104
43
|
export type { Resource, ResourceTemplate };
|
|
105
44
|
//# sourceMappingURL=types.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,MAAM,EACN,aAAa,EACb,QAAQ,EACR,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,gCAAgC,GAAG,CAAC,EAC9C,GAAG,GACJ,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;CACb,KAAK,OAAO,CAAC,wBAAwB,GAAG,wBAAwB,EAAE,CAAC,CAAC;AACrE,MAAM,MAAM,wBAAwB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzC,kBAAkB,EAAE,gCAAgC,CAAC;IACrD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,CAAC,EAC7C,IAAI,EACJ,OAAO,EACP,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;AAE/B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,iBAAiB,CAAC,EAAE,+BAA+B,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEnE,MAAM,MAAM,OAAO,CACjB,SAAS,SAAS,CAAC,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,EACrD,UAAU,SAAS,CAAC,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,IACpD;IACF,EAAE,CAAC,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAC9C,UAAU,EAAE,SAAS,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IACrE,YAAY,CAAC,EAAE,UAAU,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;IAC1E,OAAO,EAAE,CACP,MAAM,EAAE;QAAE,OAAO,EAAE,SAAS,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,GAAG,CAAA;KAAE,EAC7E,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QACjE,WAAW,EAAE,kBAAkB,CAAC;QAChC,KAAK,EAAE,sBAAsB,CAAC;KAC/B,KACE,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC;AAEF,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0-alpha.0",
|
|
4
4
|
"description": "",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
"zod-from-json-schema-v3": "npm:zod-from-json-schema@^0.0.5"
|
|
37
37
|
},
|
|
38
38
|
"peerDependencies": {
|
|
39
|
-
"@mastra/core": ">=0.
|
|
39
|
+
"@mastra/core": ">=0.16.1-0 <0.17.0-0",
|
|
40
40
|
"zod": "^3.25.0 || ^4.0.0"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
@@ -57,8 +57,8 @@
|
|
|
57
57
|
"zod": "^3.25.76",
|
|
58
58
|
"zod-to-json-schema": "^3.24.6",
|
|
59
59
|
"@internal/lint": "0.0.36",
|
|
60
|
-
"@
|
|
61
|
-
"@
|
|
60
|
+
"@mastra/core": "0.16.1-alpha.0",
|
|
61
|
+
"@internal/types-builder": "0.0.11"
|
|
62
62
|
},
|
|
63
63
|
"homepage": "https://mastra.ai",
|
|
64
64
|
"repository": {
|