A TypeScript SDK for running MCP (Model Context Protocol) servers with process reuse capabilities
Overview
what is mcp-runner?
mcp-runner is a TypeScript SDK and CLI designed for running MCP (Model Context Protocol) servers with process reuse capabilities, allowing for efficient server management and execution.
how to use mcp-runner?
To use mcp-runner, install it via npm and utilize the command-line interface or import it into your TypeScript projects to run MCP servers based on configurations defined in cline_mcp_settings.json.
key features of mcp-runner?
- Server process reuse across multiple calls
- Graceful termination with timeout handling
- Automatic server lifecycle management
- TypeScript support
- Comprehensive error handling and logging
use cases of mcp-runner?
- Running multiple MCP server instances efficiently.
- Managing server processes for various tools in a single application.
- Automating server interactions in TypeScript projects.
FAQ from mcp-runner?
- Can mcp-runner be used with any MCP server?
Yes!
mcp-runneris designed to work with any server that follows the Model Context Protocol.
- Is there a command-line interface available?
Yes!
mcp-runnerincludes a CLI for easy interaction with MCP servers.
- How do I handle errors while using mcp-runner?
The SDK includes comprehensive error handling for server process errors, tool execution errors, and timeout handling.