swift-mcp-client

Server Management

The MCPServerManager class offers a streamlined approach to managing multiple MCP server instances, encompassing server lifecycle, connection management, and tool discovery.

Usage

The code snippet illustrates loading server configurations from a servers.json file using MCPServersConfig.load. A MCPServerManager instance is created to start servers, yielding a dictionary mapping server names to their discovered tools. A client instance for a specific server (e.g., "filesystem") is retrieved to execute tool calls, exemplified by listing a directory. Finally, manager.stopAll() halts all servers.

The servers.json example demonstrates configuring a server with its command, arguments, and environment variables.

Key Features

• Multiple Server Management: Enables simultaneous startup and management of multiple MCP servers.
• Automatic Tool Discovery: Automatically identifies and provides access to each server's available tools upon initialization.
• Timeout Handling: Incorporates timeout mechanisms for server connection attempts.
• Resource Cleanup: Ensures proper connection closure and resource cleanup during server shutdown.
• Error Handling: Provides robust error handling for server startup and connection processes.

Configuration

MCPServersConfig allows specifying server configurations in a JSON file, loaded via the load function. Configurations include the server executable, command-line arguments, and environment variables. Each server is uniquely identified by a name used for client retrieval. Server startup failures propagate as an MCPError, halting the startup process.