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
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.
@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.
Beamlit MCP Server
An MCP server implementation that enables seamless integration between Beamlit CLI and AI models using the Model Context Protocol standard.
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.
systemd-coredump MCP Server
Enables MCP-capable applications to access, manage, and analyze system core dumps through integration with systemd-coredump functionality.
Terminal Controller for MCP
An MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.
Apple Shortcuts Server
An MCP Server Integration with Apple Shortcuts
mac-apps-launcher
An MCP server to list and launch applications on MacOS
applescript-mcp
Enables LLM applications to interact with macOS through AppleScript.
Bazel MCP Server
A local MCP server that exposes Bazel build system functionality to AI agents, allowing them to build, test, query, and manage Bazel projects through natural language even in environments where Bazel can't be directly accessed.