Skip to main content

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​

MCPClient

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​

MCPServerConfig

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​

MCPClient[]


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