MCP Shell Server

🚀 MCP Shell Server 日本語ドキュメント

このサーバーは、Model Context Protocol (MCP) を使用して shell コマンドを実行するものです。AI エージェントが安全に shell コマンドを実行できるようにする橋渡しの役割を果たします。

✨ 主な機能

• shell コマンドの実行（単行および複数行コマンドに対応）
• 複数の shell（bash、zsh、fish、powershell、cmd など）に対応
• 詳細なエラー処理とログ記録
• MCP Inspector との互換性

📦 インストール

npm からのインストール（ユーザー向け）

# npm を使用する場合
npm install -g @mkusaka/mcp-shell-server

# yarn を使用する場合
yarn global add @mkusaka/mcp-shell-server

# pnpm を使用する場合
pnpm add -g @mkusaka/mcp-shell-server

ソースコードからのインストール（開発用）

# リポジトリをクローンする
git clone https://github.com/mkusaka/mcp-shell-server.git
cd mcp-shell-server

# 依存関係をインストールする
pnpm install

# プロジェクトをビルドする
pnpm build

📚 ドキュメント

MCP 設定

カーソル設定

以下の内容をあなたのカーソル設定ファイル（~/.cursor/config.json）に追加してください。

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": ["-y", "@mkusaka/mcp-shell-server"]
    }
  }
}

Cline 統合

以下の内容を ~/.config/cursor/cursor.json に追加してください。

{
  "shell": {
    "serverUrl": "http://localhost:13000"
  }
}

使用方法

基本コマンドの実行

npx mcp-shell-server

システム情報の取得

以下のエンドポイントにアクセスしてシステム情報を取得できます。

• http://localhost:13000/system-info
• http://localhost:13000/shell（現在使用している shell のパスを返します）

設定オプション

npx mcp-shell-server --port=13000 --config=config.json

パラメータの説明：

• --port：サーバーがリッスンするポートを指定します。デフォルトは 13000 です。
• --config：設定ファイルのパスを指定します。

💻 使用例

基本的な使用法

{
  "name": "shell_exec",
  "parameters": {
    "command": "echo Hello, World!"
  }
}

高度な使用法

{
  "name": "shell_exec",
  "parameters": {
    "command": "cat << EOF | grep 'example'\nThis is an example text.\nAnother line without the keyword.\nEOF"
  }
}

🔧 技術詳細

プロジェクト構造

src/
├── index.ts                # メインエントリーファイル
└── shell-server/
    ├── index.ts            # Shell サーバーの実装
    └── lib/
        └── logger.ts       # ログ設定

ログ記録

ログは mcp-shell.log ファイルに出力されます。

📄 ライセンス

MIT