mcp-script-runner
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.