MCP Client TypeScript

Example Use Cases

• 1

  Real-time conversational streaming via Server-Sent Events to push assistant responses and intermediate tool outputs to clients.

• 2

  Managed sessions and stateful conversation contexts with the ability to inject messages, clear sessions, and control active streams.

• 3

  Coordinate tool execution and external model APIs (e.g., OpenAI) while enforcing user approvals and permission workflows.

Description

This repository provides a modular, TypeScript-based Node.js client for interacting with MCP servers, featuring session management, OpenAI integration, and server-sent events for real-time chat. It includes components for tool permission handling, injecting assistant messages, and clearing sessions, organized with Clean Code and SOLID principles. The design separates concerns across services, controllers, middleware, and routes to make it easy to extend or integrate into agent systems. Useful for building agent backends that require reliable MCP connections and orchestrated tool usage.