Permshell

🚀 壳権限 MCP サーバ

このサーバは、モデルコンテキストプロトコル (MCP) をベースに構築されており、権限通知付きのシェルコマンド実行を可能にします。

🚀 クイックスタート

このサーバは、モデルコンテキストプロトコル (MCP) 上に構築され、権限通知付きでシェルコマンドを実行するためのものです。以下に、その概要と使い方を説明します。

✨ 主な機能

• -growl 通知を通じて、明示的な権限付きでシェルコマンドを実行します。
• モデルコンテキストプロトコル上に構築され、大規模言語モデルツールの標準化を実現します。
• 多重保護措置により、許可されていないコマンドの実行を防止します。
• 権限ダイアログで、実行される具体的なコマンドを透明に表示します。

📦 インストール

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

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

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

💻 使用例

基本的な使用法

独立したツールとして実行する

# サーバを直接起動する
npm start

Claude Desktop に統合する

Claude Desktop の設定ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

高度な使用法

利用可能なツール

execute-command

権限付きでシェルコマンドを実行します。 例：

あなたは私のホームディレクトリ内のファイルをリストできますか？

system-info

システム情報を取得します。これには、オペレーティングシステム、稼働時間、メモリ、ディスク、および CPU の詳細が含まれます。 例：

私のシステム情報は何ですか？

🔧 技術詳細

セキュリティに関する注意事項

• すべてのコマンドは、デスクトップ通知を通じて明示的な承認が必要です。
• 作業ディレクトリを表示し、完全な透明性を実現します。
• タイムアウト制限により、プロセスが無制限に実行されるのを防止します。
• 入力の浄化により、コマンドインジェクション攻撃を防止します。

開発ガイド

# 開発モードで実行する
npm run dev