Advertise
MCP.so
Sign In

MCPShell MCP Server

@inercia

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

inercia

About MCPShell MCP Server

Use shell scripts as MCP tools

#mcp#analysis-tool#shell#cli

MCPShell MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

MCPShell MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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/MCPShell@v0.1.8 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

Frequently asked questions

1

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.

2

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.

3

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.

Comments

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Advertise