# 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.