mcpField
S
Shell Exec

Shell Exec

ローカル
github.com開発ツール94 日前に更新
リポジトリ公式サイト

Shell Exec について

Shell Execは、Bashコマンドを実行するMCPサーバーです。MCPクライアント経由でコマンド実行やバックグラウンドジョブの管理を行いたい開発者向けで、実行と状態確認のツールを備えています。

主な機能

  1. 01Bashコマンドの実行
  2. 02タイムアウトとバックグラウンド実行
  3. 03バックグラウンドジョブの状態確認

活用シーン

  1. 01ビルドコマンドを実行して出力を確認
  2. 02シェルコマンドによるファイル管理
  3. 03長時間プロセスの起動と確認

MCP 対応

MCPサーバーとして、Bashコマンドの実行とバックグラウンドジョブの状態確認を行う`execute`および`get_job_status`ツールを公開します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "domdomegg-shell-exec": {
      "command": "npx",
      "args": [
        "-y",
        "shell-exec-mcp"
      ],
      "env": {
        "MCP_TRANSPORT": "<MCP_TRANSPORT>"
      }
    }
  }
}
起動コマンドnpx -y shell-exec-mcp
設定が必要な環境変数
MCP_TRANSPORTTransport type.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmshell-exec-mcp1.2.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

shell-exec-mcp

バックグラウンドジョブに対応した、bash コマンドを実行する MCP サーバーです。

ユースケース

ビルドコマンドの実行：npm run build、make、その他のビルドツールを実行して、出力を取得します。

ファイル操作：find、grep、mv、rm、mkdir -p、stat などを使ってファイルを管理します。

長時間実行タスク：サーバーや監視プロセスをバックグラウンドモードで起動し、後から状態を確認します。

システム情報：df -h、ps aux、env などを実行して、システムの状態を調べます。

セットアップ

install-mcp の手順に従ってください。お使いの MCP クライアント（Claude Code、Claude Desktop、Cursor、Cline、VS Code など）に適した設定が生成されます。

ツール

ツール説明
executebash コマンドを実行します（タイムアウトとバックグラウンドモードは任意で指定できます）
get_job_statusバックグラウンドジョブの状態を確認します

貢献

GitHub でのプルリクエストを歓迎します！始めるには、次の手順に従ってください。

  1. Git と Node.js をインストールします
  2. リポジトリをクローンします
  3. npm install で依存関係をインストールします
  4. npm run test を実行してテストを実行します
  5. npm run build でビルドします

リリース

バージョンにはセマンティックバージョニングの仕様が適用されます。

リリースするには、次の手順に従ってください。

  1. npm version <major | minor | patch> を使ってバージョンを更新します
  2. git push --follow-tags を実行してタグとともにプッシュします
  3. GitHub Actions が NPM レジストリに公開するまで待ちます。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。