MCP Script Runner
A mcp server that executes shell scripts in a designated folder as tools.
ktrysmt
README
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.
Recommended Servers
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
ThingsPanel MCP
An integration server that connects AI models with ThingsPanel IoT platform, allowing AI assistants to interact with IoT devices through natural language for device control, data retrieval, and management operations.
Beamlit MCP Server
An MCP server implementation that enables seamless integration between Beamlit CLI and AI models using the Model Context Protocol standard.
iTerm MCP Server
This MCP server enables users to execute shell commands in the current iTerm2 session through integration with Claude Desktop, facilitating seamless command execution via the Model Context Protocol.
MCP Command Server
A secure server that allows LLM applications like Claude to execute whitelisted system commands with user confirmation and comprehensive security features.
WinTerm MCP
A Model Context Protocol server that provides programmatic access to the Windows terminal, enabling AI models to interact with the Windows command line through standardized tools for writing commands, reading output, and sending control signals.
Everything Search MCP Server
Provides integration with Everything Search Engine allowing powerful file search capabilities through the Model Context Protocol with advanced search options like regex, case sensitivity, and sorting.
MCP Server: SSH Rails Runner
Enables secure remote execution of Rails console commands over SSH for read-only operations, mutation planning, and executing approved changes in a deployed Rails environment.
Blender MCP Server
A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.