Advertise
MCP.so
Sign In

MCP Script Runner

@ktrysmt

Repository

Basic information

Category

Other

Last updated

Transports

stdio

Author

ktrysmt

About MCP Script Runner

A mcp server that executes shell scripts in a designated folder as tools.

MCP Script Runner config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-script-runner": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-script-runner",
        "run",
        "main.py"
      ]
    }
  }
}

MCP Script 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 Script Runner?

MCP Script Runner is an MCP server that executes shell scripts as tools. It integrates with the Model Context Protocol and requires Python 3.13 and the uv package manager. The server is intended for developers who want to run local, trusted scripts through an MCP client.

How to use MCP Script Runner?

Clone the repository, run uv sync to install dependencies, then add a JSON configuration to your MCP client. The configuration specifies the command as uv with arguments pointing to main.py. Optionally, set the COMMAND_DIRECTORY environment variable to change the working directory, or use a .env file for additional environment variables.

Key features of MCP Script Runner

  • Runs shell scripts as MCP tools.
  • Customizable command directory via COMMAND_DIRECTORY env var.
  • Supports dotenv files for environment variables.
  • Simple tool addition by placing scripts in ./commands/.
  • Automatically adjusts file execution permissions.

Use cases of MCP Script Runner

  • Execute local automation scripts from any MCP client.
  • Run system maintenance commands through an AI assistant.
  • Integrate custom shell scripts into AI‑powered workflows.
  • Safely run only scripts you understand in a local environment.

Frequently asked questions

1

What are the prerequisites?

Python 3.13 (e.g., via `mise`) and `uv` (e.g., via Homebrew).

2

How do I add a new tool?

Create a shell script in the `./commands/` directory (e.g., `command_name.sh`) and reload the MCP server.

3

What precautions should I take?

Each script must include a shebang, have execute permission (auto‑adjusted), and be intended for local use only. Only place scripts you fully understand.

4

How do I change the working directory for script execution?

Set the `COMMAND_DIRECTORY` environment variable in your MCP client’s configuration for the server entry.

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

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Soar Flight Booking MCP

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

Glasswarp

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.

Advertise