mkusaka_mcp-shell-server
The MCP Shell Server is designed to enable AI agents to safely execute shell commands using the Model Context Protocol. It supports various shells and includes features for error handling and logging, making it compatible with the MCP Inspector.
MCP Shell Server
A server that utilizes the Model Context Protocol (MCP) to facilitate the execution of shell commands by AI agents. It ensures safety in executing shell commands and serves as a bridge.
Features
- Execute single-line and multi-line shell commands
- Compatible with multiple shells (bash, zsh, fish, powershell, cmd, etc.)
- Detailed error handling and logging
- Compatible with MCP Inspector
Installation
From npm (as a user)
Install globally using npm, yarn, or pnpm.
From source (for development)
Clone the repository, install dependencies, and build the project.
MCP Configuration
Cursor Configuration
Details on how to configure the MCP server with Cursor.
Rule Configuration
Rules for tool usage with MCP server.
Usage
Direct Execution
Execution of the server via Node.js.
Development Mode
Run in development mode using pnpm.
Testing with MCP Inspector
Use pnpm to test the server with MCP Inspector.
Command Line Arguments
- Various flags for shell specification, help display, and version information.
Resource Reference
Provides system information like hostname, platform, shell, username, and system-info.