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.

よくある質問

What are the prerequisites?

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

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.

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.

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.

「その他」の他のコンテンツ

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov