Odysseus0 MCP Server Shell

🚀 Shell MCP サーバ

このサーバは、シェルコマンドの実行機能を提供するモデルコンテキストプロトコル (Model Context Protocol) サーバです。大型言語モデル (LLM) が制御された方法でシェルコマンドを実行し、その出力を受け取ることを可能にします。

✨ 主な機能

利用可能なツール

• execute_command - シェルコマンドを実行し、その出力を返します
  • 必須パラメータ：
    • command（文字列）：実行するシェルコマンド
  • 返り値：
    • コマンド結果には以下が含まれます：
      • command：実行されたコマンド
      • output：標準出力と標準エラー出力を結合したもの
      • return_code：コマンド実行の戻りコード

📦 インストール

uv を使用する場合（推奨）

uv を使用する場合、特定のインストールは必要ありません。uvx を直接使用して mcp-server-shell を実行します。

PIP を使用する場合

または、pip を使用して mcp-server-shell をインストールできます：

pip install mcp-server-shell

インストール後、スクリプトとして実行できます：

python -m mcp_server_shell

📚 ドキュメント

Claude.app の設定

Claude の設定に以下を追加します：

Zed の設定

Zed の settings.json に以下を追加します：

💻 使用例

基本的な使用法

シェルコマンドを実行する例：

{
  "name": "execute_command",
  "arguments": {
    "command": "ls -la"
  }
}

応答：

{
  "command": "ls -la",
  "output": "total 24\ndrwxr-xr-x  5 user  group   160 Jan  1 12:00 .\ndrwxr-xr-x  3 user  group    96 Jan  1 12:00 ..",
  "return_code": 0
}

🔧 技術詳細

デバッグ

MCP モニターを使用してサーバをデバッグできます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx mcp-server-shell

または、特定のディレクトリにパッケージをインストールまたは開発している場合：

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv mcp_server_shell

セキュリティ上の注意事項

• 入力検証：常にユーザーが提供した入力を検証し、コマンドインジェクション攻撃を避けます。
• 権限管理：サーバが実行するコマンドの権限を制限し、承認された操作のみを許可します。

貢献ガイド

このプロジェクトに貢献するには、以下の手順に従ってください：

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. フォークしたリポジトリにプッシュします。
5. プルリクエストを送信します。

問題を報告または機能リクエストを行う場合は、GitHub で問題を開いてください。

📄 ライセンス

[ここにライセンス情報を追加]

mcp-server-shell をご利用いただき、ありがとうございます！このサーバがあなたのプロジェクトに強力なシェルコマンド実行機能を提供することを願っています。