mcp-script-runner

mcp-script-runner

3.2

If you are the rightful owner of mcp-script-runner and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Script Runner is a tool designed to facilitate the execution of scripts using the Model Context Protocol (MCP) framework.

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.