MCPShell

Name: MCPShell
Author: inercia

@inercia

代码仓库

关于 MCPShell

Use shell scripts as MCP tools

#mcp #analysis-tool #shell #cli

基本信息

分类

其他

许可证

MIT

运行时

传输方式

stdio

发布者

inercia

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcpshell": {
      "command": "go",
      "args": [
        "run",
        "github.com/inercia/[email protected]",
        "mcp",
        "--config",
        "https://raw.githubusercontent.com/inercia/MCPShell/refs/heads/main/examples/kubectl-ro.yaml"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCPShell?

MCPShell is a tool that allows LLMs to safely execute command-line tools through the Model Context Protocol (MCP). It provides a secure bridge between LLMs and operating system commands, enabling AI assistants to run shell commands with configurable constraints and parameter validation.

How to use MCPShell?

Create a YAML configuration file defining your tools with parameters, constraints, and the shell command to run. Then configure MCPShell as an MCP server in your LLM client (e.g., Cursor, VS Code) using go run github.com/inercia/[email protected] mcp --tools <config>. After refreshing the client, you can ask the LLM questions that require command execution.

Key features of MCPShell

Flexible command execution with parameter substitution through templates
Configuration-based tool definitions in YAML with parameters and constraints
Security through CEL expression validation and optional sandboxed environments
Quick prototyping of MCP tools by adding shell code
Simple integration with any LLM client supporting the MCP protocol

Use cases of MCPShell

Analyzing disk usage to identify space-consuming directories
Running Kubernetes commands via kubectl for cluster management
Executing AWS CLI commands for network diagnostics

FAQ from MCPShell

What makes MCPShell secure for executing shell commands?

MCPShell validates tool parameters using CEL expressions before execution, and optionally runs commands in sandboxed environments. The README strongly recommends limiting tools to read-only actions and reviewing templates for injection vulnerabilities.

Does MCPShell require specific runtime dependencies?

Yes, the go command must be available to run MCPShell, as it is invoked via go run. The tool itself is written in Go and fetched from GitHub.

Where are tool configurations stored?

Tool definitions are stored in YAML files. By default, MCPShell looks for them in the ~/.mcpshell/tools/ directory, though custom paths can be specified with the --tools argument and relative paths are supported.