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

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Codelf

unbug

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

14.2K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

FastMCP v2 🚀

jlowin

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

26.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Advertise