Advertise
MCP.so
Sign In

MCP Runner

@cookiecad

Repository

Basic information

Category

Other

Transports

stdio

Author

cookiecad

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

1

Where does mcp-runner read server configurations from?

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

2

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

The first available tool is used automatically.

3

Does mcp-runner support output filtering?

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

4

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.

5

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

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Advertise