MCP Runner

@cookiecad

Repository

Basic information

About MCP Runner

A TypeScript SDK for running MCP (Model Context Protocol) servers with process reuse capabilities

#mcp-runner#typescript-sdk #mcp-servers

MCP Runner config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

MCP Runner tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-runner?

mcp-runner is a TypeScript SDK and CLI for running MCP (Model Context Protocol) servers. It reads configurations from cline_mcp_settings.json and allows reusable server processes with controlled cleanup, enabling multiple operations using the same server instance.

How to use mcp-runner?

Install via npm install, then use CLI commands (e.g., npm run cli -- list-tools <server-name> or npm run cli -- runserver <server-name> [tool-name] [params] [options]). Alternatively, import runServer and terminateServer in your TypeScript code.

Key features of mcp-runner

Server process reuse across multiple calls
Graceful termination with timeout handling
Automatic server lifecycle management
TypeScript support
Error handling and logging
Single server process at a time (singleton)

Use cases of mcp-runner

Running MCP servers from the command line
Integrating MCP server calls into TypeScript projects
Using mcp-runner from other MCP servers
Automating tool execution with reusable server instances

Frequently asked questions

Where does mcp-runner read server configurations from?

It reads from `cline_mcp_settings.json` located in the standard configuration directory.

What happens if no tool name is specified when running a server?

The first available tool is used automatically.

Does mcp-runner support output filtering?

Yes, the `--text` flag outputs only the text content instead of the full JSON response.

How does mcp-runner manage server processes?

The `ServerManager` is a singleton that ensures only one server process runs at a time; it handles lifecycle, connection, graceful termination, and cleanup.

Do I need to explicitly stop the server after use?

Yes, call `terminateServer()` when all operations are complete, or it will be terminated automatically on errors.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.