Script Tool

スクリプトツール

MCP を通じてコマンドラインスクリプトを実行するツールです。

機能

• コマンドラインスクリプトを安全に実行
• さまざまなインタープリターに対応
• タイムアウト保護
• 出力とエラーをキャプチャ
• クロスプラットフォーム対応（Linux、macOS、Windows）

インストール

スクリプトツールをインストールする方法はいくつかあります。

オプション 1：GitHub Releases からダウンロード

1. GitHub Releases ページにアクセスします
2. お使いのプラットフォーム用のバイナリをダウンロードします：
   • script-mcp_linux_amd64`（Linux 用）
   • script-mcp_darwin_amd64（macOS 用）
   • script-mcp_windows_amd64.exe（Windows 用）
3. バイナリに実行権限を付与します（Linux/macOS）：

   chmod +x script-mcp_*
   

4. PATH に移動します（Linux/macOS）：

   sudo mv script-mcp_* /usr/local/bin/script-mcp@latest
   

オプション 2：Go install

go install github.com/nguyenvanduocit/script-mcp

設定

Claude

{
  "mcpServers": {
    "script": {
      "command": "/path-to/script-mcp"
    }
  }
}

CLI の使用方法

MCP サーバーに加えて、script-mcp にはスタンドアロンの CLI バイナリ（script-cli）が付属しており、MCP クライアントなしでターミナルから直接使用できます。

インストール

just install-cli
# or
go install github.com/nguyenvanduocit/script-mcp/cmd/script-cli@latest

クイックスタート

認証情報は不要です。CLI はスクリプトをローカルで実行します。

script-cli execute --content "echo Hello, World!"

コマンド

コマンド	説明
execute（または exec、run）	タイムアウトを設定してスクリプトを安全に実行します

使用例

# Run a shell command
script-cli execute --content "ls -la"

# Run with a specific interpreter
script-cli execute --content "print('Hello')" --interpreter /usr/bin/python3

# Run with a working directory
script-cli execute --content "pwd" --working-dir /tmp

# Run a multi-line script
script-cli execute --content "#!/bin/bash
echo 'Starting...'
date
echo 'Done'"

# JSON output (captures stdout/stderr separately)
script-cli exec --content "echo hello" --output json

フラグ

フラグ	説明
--content	実行するスクリプトの内容（必須）
--interpreter	インタープリターのパス（デフォルト：/bin/sh）
--working-dir	実行時の作業ディレクトリ
--env	.env ファイルのパス
--output	出力形式：text（デフォルト）または json

注： スクリプトは 30 秒後にタイムアウトします。

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は LICENSE ファイルを参照してください。

インストール

Homebrew（macOS/Linux）

brew install nguyenvanduocit/tap/script-mcp