Class: MCPManager
Defined in: packages/mcp/src/manager.ts:59
Provides a unified interface for connecting to multiple MCP servers and aggregating their tools, resources, and prompts.
Example
const manager = new MCPManager();
// Add multiple servers
await manager.addServer({
name: 'github',
transport: { type: 'stdio', command: 'npx', args: ['-y', '@mcp/server-github'] },
toolPrefix: 'github_'
});
await manager.addServer({
name: 'filesystem',
transport: { type: 'stdio', command: 'npx', args: ['-y', '@mcp/server-filesystem'] },
toolPrefix: 'fs_'
});
// Get all tools as Baleybot-compatible tools
const tools = await manager.getTools();
const bot = Baleybot.create({
name: 'assistant',
goal: 'Help with files and code',
tools
});
// Cleanup
await manager.disconnectAll();
Constructors
Constructor
new MCPManager(
options?):MCPManager
Defined in: packages/mcp/src/manager.ts:66
Parameters
options?
MCPClientOptions & object = {}
Returns
MCPManager
Methods
addClientDirectly()
addClientDirectly(
name,client):void
Defined in: packages/mcp/src/manager.ts:133
For a client you already created and connected yourself (e.g. with
connectWithTransport and a custom MCPTransport).
Parameters
name
string
client
Returns
void
addServer()
addServer(
config):Promise<MCPClient>
Defined in: packages/mcp/src/manager.ts:98
Connects unless config.autoConnect is false. Throws if the name is already registered.
Parameters
config
Returns
Promise<MCPClient>
disconnectAll()
disconnectAll():
Promise<void>
Defined in: packages/mcp/src/manager.ts:177
Returns
Promise<void>
getAllClients()
getAllClients():
MCPClient[]
Defined in: packages/mcp/src/manager.ts:168
Returns
getClient()
getClient(
name):MCPClient|undefined
Defined in: packages/mcp/src/manager.ts:160
Parameters
name
string
Returns
MCPClient | undefined
getPrompt()
getPrompt(
name,args?,serverName?):Promise<MCPPromptMessage[]>
Defined in: packages/mcp/src/manager.ts:334
Without serverName, tries each connected server in turn and returns the first that succeeds.
Parameters
name
string
args?
Record<string, string>
serverName?
string
Returns
Promise<MCPPromptMessage[]>
getServerNames()
getServerNames():
string[]
Defined in: packages/mcp/src/manager.ts:164
Returns
string[]
getTools()
getTools(
options?):Promise<Record<string,MCPToolDefinition>>
Defined in: packages/mcp/src/manager.ts:198
Tools from every connected server, cached per server until it is removed or refresh is passed.
Parameters
options?
refresh?
boolean
Returns
Promise<Record<string, MCPToolDefinition>>
getToolsFromServer()
getToolsFromServer(
serverName):Promise<Record<string,MCPToolDefinition>>
Defined in: packages/mcp/src/manager.ts:225
Parameters
serverName
string
Returns
Promise<Record<string, MCPToolDefinition>>
isConnected()
isConnected(
name):boolean
Defined in: packages/mcp/src/manager.ts:172
Parameters
name
string
Returns
boolean
listAllPrompts()
listAllPrompts():
Promise<MCPPromptWithServer[]>
Defined in: packages/mcp/src/manager.ts:313
Returns
Promise<MCPPromptWithServer[]>
listAllResources()
listAllResources():
Promise<MCPResourceWithServer[]>
Defined in: packages/mcp/src/manager.ts:266
Returns
Promise<MCPResourceWithServer[]>
listAllTools()
listAllTools():
Promise<MCPToolWithServer[]>
Defined in: packages/mcp/src/manager.ts:246
Returns
Promise<MCPToolWithServer[]>
readResource()
readResource(
uri,serverName?):Promise<MCPResourceContent>
Defined in: packages/mcp/src/manager.ts:287
Without serverName, tries each connected server in turn and returns the first that succeeds.
Parameters
uri
string
serverName?
string
Returns
Promise<MCPResourceContent>
removeServer()
removeServer(
name):Promise<void>
Defined in: packages/mcp/src/manager.ts:143
Parameters
name
string
Returns
Promise<void>
touchServer()
touchServer(
name):void
Defined in: packages/mcp/src/manager.ts:91
Reset the idle timeout for a server (call on tool use to prevent auto-disconnect).
Parameters
name
string
Returns
void