Submit

mcp-runner

@cookiecad

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?

  1. Running multiple MCP server instances efficiently.
  2. Managing server processes for various tools in a single application.
  3. Automating server interactions in TypeScript projects.

FAQ from mcp-runner?

  • Can mcp-runner be used with any MCP server?

Yes! mcp-runner is designed to work with any server that follows the Model Context Protocol.

  • Is there a command-line interface available?

Yes! mcp-runner includes 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.

© 2025 MCP.so. All rights reserved.

Build with ShipAny.