Mastra.getMCPServerById()

.getMCPServerById() 方法按固有 id 属性获取 MCP server 实例。要按注册键（配置中使用的键）获取，请改用 .getMCPServer()。

使用示例

// Register an MCP server with a registry key
const myServer = new MCPServer({
  id: 'my-mcp-server',
  name: 'My Server',
  version: '1.0.0',
  tools: {/* ... */},
})

export const mastra = new Mastra({
  mcpServers: {
    customKey: myServer, // 'customKey' is the registry key
  },
})

// Retrieve by intrinsic ID
const server = mastra.getMCPServerById('my-mcp-server')

// Alternatively, retrieve by registry key
const serverByKey = mastra.getMCPServer('customKey')

参数

serverId:

string

MCP server 的固有 id 属性（实例化 server 时设置）。

version?:

string

可选。提供后，仅当版本匹配时才返回 server。

返回值

server:

MCPServerBase | undefined

具有指定 id（以及提供时的版本）的 MCP server 实例；如果未找到，则为 undefined。

注意事项

• server 的 id 会在构造期间进行 slug 化，因此 'myMcpServer' becomes 'my-mcp-server'
• 如果多个 server 具有相同 id 但版本不同，则必须提供 version 参数以消除歧义
• 如果未提供 version 且存在多个版本，此方法返回第一个匹配项

相关方法

• Mastra.getMCPServer(): 按注册键获取 MCP server
• Mastra.listMCPServers(): 列出所有已注册的 MCP server

另请参阅

• MCP 概览
• MCP server 参考