MCP Script Runner

🚀 MCP Script Runner

MCP Script Runner is a tool that simplifies the process of running scripts. It provides a convenient way to manage and execute scripts with specific configurations.

🚀 Quick Start

📦 Prerequisites

• python: For example, mise install python@3.13 && mise use python@3.13 -g
• uv: For example, brew install uv

⚙️ Configuration

First, clone the repository and synchronize:

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

Then, add mcp.json to the mcp configuration as follows:

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

Change the command directory:

{
  "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

➕ Adding Tools

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

Then reload mcp.

⚠️ Important Note

⚠️ Important Note

• Since files are executed directly, don't forget to include a shebang in each file.
• Execution permissions are required for files (although there is a process to adjust permissions).
• This is only for local use, and only scripts you understand should be placed here.