MCP Client Toolkit

TypeScript client library and utilities for remote Model Context Protocol (MCP) servers.

Basic Client

import { MCPClient, BrowserOAuthHandler } from 'mcp-client-toolkit';

const client = new MCPClient({
  callbackPort: 8090,
  oauthHandler: new BrowserOAuthHandler(8090)
});

await client.connect('http://localhost:3000/mcp');

CLI Utilities

import { 
  listTools, 
  showToolDetails, 
  callTool,
  parseToolCallCommand 
} from 'mcp-client-toolkit';

const mcpClient = client.getClient();
if (mcpClient) {
  await listTools(mcpClient);
  await showToolDetails(mcpClient, 'tool-name');
  await callTool(mcpClient, 'tool-name', { param: 'value' });
}

Exports

• MCPClient: Main client class
• BrowserOAuthHandler, CustomOAuthHandler: OAuth handlers
• ConnectionManager: Connection management
• listTools, showToolDetails, callTool: CLI utilities
• formatJsonSchema, generateExampleArgs: Schema utilities
• Types: MCPClientConfig, OAuthHandler, TransportType, etc.

Features

• OAuth 2.0 authentication support
• Automatic transport fallback (HTTP → SSE)
• Connection management
• Tool discovery and execution
• Real-time notifications
• Reusable CLI command utilities