MCP Shell Server

Name: MCP Shell Server
Author: MCP-Mirror

@MCP-Mirror

リポジトリ

MCP Shell Server について

Mirror of

#mcp-shell-server #shell-execution #ai-agents

基本情報

カテゴリ

開発者ツール

ライセンス

MIT license

ランタイム

node

トランスポート

stdio

公開者

MCP-Mirror

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mkusaka_mcp-shell-server": {
      "command": "node",
      "args": [
        "dist/index.js"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP Shell Server?

MCP Shell Server is a bridge that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands. It supports single-line and multi-line commands across multiple shells and is designed for integration with AI assistants like Cursor.

How to use MCP Shell Server?

Install globally via npm, yarn, or pnpm, then add the server to your MCP configuration (e.g., in Cursor's ~/.cursor/config.json). The server provides a shell_exec tool that accepts a required command string. You can also specify a custom shell using the -s or --shell command-line argument.

Key features of MCP Shell Server

Execute shell commands (single-line and multi-line support)
Support for various shells (bash, zsh, fish, powershell, cmd, etc.)
Detailed error handling and logging
MCP Inspector compatible
Provides system information as resources (hostname, platform, shell, username, system-info)

Use cases of MCP Shell Server

AI assistants executing shell commands to solve coding tasks
Retrieving system information (hostname, platform, memory, uptime) during agent interactions
Running multi-line scripts (e.g., heredoc) via AI tools
Debugging and system administration through natural language interfaces

FAQ from MCP Shell Server

What shells does MCP Shell Server support?

It supports bash, zsh, fish, powershell, cmd, and others. You can specify a custom shell path with the -s or --shell argument when starting the server.

What is the required parameter for the `shell_exec` tool?

The command parameter is required and must be a string containing the shell command to execute.

How do I install MCP Shell Server?

Install it globally: npm install -g @mkusaka/mcp-shell-server, yarn global add @mkusaka/mcp-shell-server, or pnpm add -g @mkusaka/mcp-shell-server.

What system resources does MCP Shell Server expose?

It exposes hostname://, platform://, shell://, username://, and system-info:// (which returns hostname, platform, shell, username, CPU count, total/free memory, and uptime).

Does MCP Shell Server support Windows shells?

Yes, it supports both powershell and cmd in addition to Unix shells like bash and zsh.

「開発者ツール」の他のコンテンツ

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

Huoshan Test

volcengine

2.4K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K