MCP Server Shell

🚀 Shell MCP サーバー

シェルコマンドの実行機能を提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーにより、大規模言語モデルはシェルコマンドを安全に実行し、その出力を受け取ることができます。

✨ 主な機能

利用可能なツール

• execute_command - シェルコマンドを実行し、その出力を返します
  • 必須パラメータ:
    • command (文字列)：実行するシェルコマンド
  • 返却内容:
    • command：実行されたコマンド
    • output：統合されたstdoutとstderrの出力
    • 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の設定に以下を追加します。

"mcpServers": {
  "shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
}

"mcpServers": {
  "shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
}

Zed用の設定

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

"context_servers": {
  "mcp-server-shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
},

"context_servers": {
  "mcp-server-shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
},

💻 使用例

基本的な使用法

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

{
  "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 run mcp-server-shell

サンプル質問（Claude向け）

1. “現在のディレクトリにはどのようなファイルがありますか？”
2. “README.mdファイルの内容を表示してください”
3. “現在のシステムの日付は何ですか？”
4. “Pythonがインストールされているか確認し、そのバージョンを表示してください”

📄 ライセンス

[ここにライセンス情報を追加してください]

⚠️ 重要提示

このサーバーはシェルコマンドを直接ローカルで実行します。潜在的なセキュリティリスクを防ぐため、入力するコマンドが信頼できるものであることを確認してください。

💡 使用建议

貢献する場合は、プロジェクトのドキュメントを参照するか、メンテナに連絡してください。