MCP.so
登录

MCP Script Runner

@ktrysmt

基本信息

分类

其他

传输方式

stdio

作者

ktrysmt

关于 MCP Script Runner

A mcp server that executes shell scripts in a designated folder as tools.

MCP Script Runner 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

MCP Script Runner 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP Script Runner?

MCP Script Runner is an MCP server that executes shell scripts as tools. It integrates with the Model Context Protocol and requires Python 3.13 and the uv package manager. The server is intended for developers who want to run local, trusted scripts through an MCP client.

How to use MCP Script Runner?

Clone the repository, run uv sync to install dependencies, then add a JSON configuration to your MCP client. The configuration specifies the command as uv with arguments pointing to main.py. Optionally, set the COMMAND_DIRECTORY environment variable to change the working directory, or use a .env file for additional environment variables.

Key features of MCP Script Runner

  • Runs shell scripts as MCP tools.
  • Customizable command directory via COMMAND_DIRECTORY env var.
  • Supports dotenv files for environment variables.
  • Simple tool addition by placing scripts in ./commands/.
  • Automatically adjusts file execution permissions.

Use cases of MCP Script Runner

  • Execute local automation scripts from any MCP client.
  • Run system maintenance commands through an AI assistant.
  • Integrate custom shell scripts into AI‑powered workflows.
  • Safely run only scripts you understand in a local environment.

常见问题

1

What are the prerequisites?

Python 3.13 (e.g., via `mise`) and `uv` (e.g., via Homebrew).

2

How do I add a new tool?

Create a shell script in the `./commands/` directory (e.g., `command_name.sh`) and reload the MCP server.

3

What precautions should I take?

Each script must include a shebang, have execute permission (auto‑adjusted), and be intended for local use only. Only place scripts you fully understand.

4

How do I change the working directory for script execution?

Set the `COMMAND_DIRECTORY` environment variable in your MCP client’s configuration for the server entry.

评论

其他 分类下的更多 MCP 服务器