mcp-script-runner

mcp-script-runner

0
developer_toolsos_automation

The MCP Script Runner is a local tool for managing and executing scripts with ease. It requires Python and uv, and allows users to add custom tools and configure environments using dotenv files. The tool is intended strictly for local, safe use.

MCP Script Runner

Prerequisites

  • python: e.g. mise install python@3.13 && mise use python@3.13 -g
  • uv: e.g. brew install uv

Configure

git clone https://github.com/ktrysmt/mcp-script-runner
cd ./mcp-script-runner
uv sync

and add mcp.json to your mcp config like this:

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

Change command dir:

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

Use dotenv:

cd ./mcp-script-runner
$EDITOR .env

Add a tool

cd ./mcp-script-runner
$EDITOR ./commands/command_name.sh

and reload the mcp.

Precautions

  • Since files are executed directly, do not forget to include the shebang in each file.
  • Execution permission is required for the files (although there is a process to adjust permissions included).
  • This is intended for local use only, and only scripts that you understand should be placed here.