Mkusaka 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

📚 ドキュメント

Cursor の設定

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

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

ルール設定

あなたの Cursor ルールファイルに以下の内容を追加してください。

あなたはタスクを解決するためのツールを利用できます。ツールの呼び出しに関する以下のルールに従ってください。
1. **常に**ツールの呼び出しパターンに完全に正確に従ってパラメータを指定してください。
2. 会話の中で提供されなくなったツールが参照されることがあります。**明示的に提供されていないツールを決して呼び出さないでください**。
3. **ユーザーとの会話の中でツール名を決して言及しないでください**。例えば、「私は shell_exec ツールを使ってあなたのコマンドを実行する必要があります」と言わずに、「私はあなたのコマンドを実行します」と直接言ってください。
4. 必要な場合にのみツールを呼び出してください。ユーザーのタスクが一般的なものであるか、あなたがすでに答えを知っている場合は、ツールを呼び出すことなく直接応答してください。
5. ツールを呼び出すたびに、まずユーザーになぜそのツールを呼び出す必要があるのかを説明してください。

💻 使用例

直接実行

node dist/index.js
# または実行可能ファイルとして実行
./dist/index.js

開発モード

pnpm dev

MCP Inspector を使用したテスト

pnpm inspect

コマンドライン引数

-s, --shell <shell>  使用する shell のパスを指定する
-h, --help           ヘルプ情報を表示する
-V, --version        バージョン情報を表示する

ツール参照

shell_exec

指定された shell 内でコマンドを実行します。

パラメータ:

• command (文字列、必須): 実行する shell コマンド

リソース参照

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

hostname

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

URI: hostname://

platform

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

URI: platform://

shell

サーバーが使用する shell のパスを返します。

URI: shell://

username

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

URI: username://

system-info

以下の情報を含む総合的なシステム情報（JSON 形式）を返します。

• ホスト名
• プラットフォーム
• shell
• ユーザー名
• CPU コア数
• 総メモリ
• 空きメモリ
• システム稼働時間

基本的な使用法

基本コマンドの実行

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

複数行コマンド（Heredoc）の実行

{
  "name": "shell_exec",
  // ここの内容は原文に続きがあるが提供されていないためそのままにしてあります
}