MCP シェルサーバー

モデルコンテキストプロトコル（MCP）を使用してシェルコマンドを実行するサーバー。AIエージェントが安全にシェルコマンドを実行できるようにするブリッジとして機能します。

特徴

シェルコマンドを実行する（単一行および複数行のサポート）
さまざまなシェル (bash、zsh、fish、powershell、cmd など) のサポート
詳細なエラー処理とログ記録
MCP Inspector対応

インストール

npmから（ユーザーとして）

# Using npm
npm install -g @mkusaka/mcp-shell-server

# Using yarn
yarn global add @mkusaka/mcp-shell-server

# Using pnpm
pnpm add -g @mkusaka/mcp-shell-server

ソースから（開発用）

# Clone the repository
git clone https://github.com/mkusaka/mcp-shell-server.git
cd mcp-shell-server

# Install dependencies
pnpm install

# Build the project
pnpm build

MCP構成

カーソルの設定

カーソル構成ファイル ( ~/.cursor/config.json ) に次のコードを追加します。

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

ルール設定

カーソルルールファイルに次のコードを追加します。

You have tools at your disposal to solve the coding task. Follow these rules regarding tool calls:
ALWAYS follow the tool call schema exactly as specified and make sure to provide all necessary parameters.
The conversation may reference tools that are no longer available. NEVER call tools that are not explicitly provided.
**NEVER refer to tool names when speaking to the USER.** For example, instead of saying 'I need to use the shell_exec tool to execute your command', just say 'I will execute your command'.
Only calls tools when they are necessary. If the USER's task is general or you already know the answer, just respond without calling tools.
Before calling each tool, first explain to the USER why you are calling it.

使用法

直接実行

node dist/index.js
# or as an executable
./dist/index.js

開発モード

pnpm dev

MCP Inspectorによるテスト

pnpm inspect

コマンドライン引数

-s, --shell <shell>  Specify the path to the shell to use
-h, --help           Display help message
-V, --version        Display version information

ツールリファレンス

シェル実行

指定されたシェルでコマンドを実行します。

パラメータ:

command （文字列、必須）: 実行するシェルコマンド

リソースリファレンス

サーバーは、リソースとして次のシステム情報を提供します。

ホスト名

システムのホスト名を返します。

URI: hostname://

プラットフォーム

オペレーティングシステムプラットフォームを返します。

URI: platform://

シェル

サーバーで使用されているシェルパスを返します。

URI: shell://

ユーザー名

現在のユーザー名を返します。

URI: username://

システム情報

以下の情報を含む包括的なシステム情報を JSON 形式で返します。

ホスト名
プラットフォーム
シェル
ユーザー名
CPU数
合計メモリ
空きメモリ
システム稼働時間

使用例

基本的なコマンド実行

{
  "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                # Main entry point
└── shell-server/
    ├── index.ts            # Shell server implementation
    └── lib/
        └── logger.ts       # Logging configuration

ログ記録

ログはmcp-shell.logファイルに書き込まれます。

ライセンス

マサチューセッツ工科大学

MCP Shell Server

Integrations

MCP シェルサーバー

特徴

インストール

npmから（ユーザーとして）

ソースから（開発用）

MCP構成

カーソルの設定

ルール設定

使用法

直接実行

開発モード

MCP Inspectorによるテスト

コマンドライン引数

ツールリファレンス

シェル実行

リソースリファレンス

ホスト名

プラットフォーム

シェル

ユーザー名

システム情報

使用例

基本的なコマンド実行

複数行コマンド（ヒアドキュメント）の実行

発達

プロジェクト構造

ログ記録

ライセンス

Tools

Appeared in Searches

Integrations

MCP シェル サーバー

特徴

インストール

npmから（ユーザーとして）

ソースから（開発用）

MCP構成

カーソルの設定

ルール設定

使用法

直接実行

開発モード

MCP Inspectorによるテスト

コマンドライン引数

ツールリファレンス

シェル実行

リソースリファレンス

ホスト名

プラットフォーム

シェル

ユーザー名

システム情報

使用例

基本的なコマンド実行

複数行コマンド（ヒアドキュメント）の実行

発達

プロジェクト構造

ログ記録

ライセンス

Tools

Appeared in Searches

MCP シェルサーバー