MCP Script Runner

🚀 MCP スクリプトランナー

MCP スクリプトランナーは、特定のスクリプトを実行するためのツールです。Python と uv を利用し、簡単に設定して使用することができます。

🚀 クイックスタート

🔧 前提条件

• python: 例えば mise install python@3.13 && mise use python@3.13 -g
• uv: 例えば brew install uv

⚙️ 設定

リポジトリをクローンし、uv を同期します。

git clone https://github.com/ktrysmt/mcp-script-runner
cd ./mcp-script-runner
uv sync

mcp.json を mcp 設定に追加します。

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

コマンドディレクトリを変更する場合は、以下のように設定します。

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

dotenv を使用する場合は、以下のコマンドを実行します。

cd ./mcp-script-runner
$EDITOR .env

🛠️ ツールの追加

新しいツールを追加するには、以下のコマンドを実行します。

cd ./mcp-script-runner
$EDITOR ./commands/command_name.sh

その後、mcp を再読み込みします。

⚠️ 注意事項

⚠️ 重要提示

• ファイルは直接実行されるため、各ファイルに shebang を含めることを忘れないでください。
• ファイルには実行権限が必要です（権限を調整するプロセスがありますが）。
• このツールはローカル使用にのみ適しており、自分が理解しているスクリプトのみをここに配置する必要があります。