Mac Shell MCP Server

@cfdude

About Mac Shell MCP Server

An MCP (Model Context Protocol) server for executing macOS terminal commands with ZSH shell. This server provides a secure way to execute shell commands with built-in whitelisting and approval mechanisms.

#zsh #mac #mcp

Config

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

{
  "mcpServers": {
    "mac-shell-mcp": {
      "command": "node",
      "args": [
        "build/index.js"
      ]
    }
  }
}

Tools

No tools detected

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

Overview

What is Mac Shell MCP Server?

Mac Shell MCP Server is an MCP (Model Context Protocol) server for executing macOS terminal commands with ZSH shell. It provides a secure way to run shell commands with built-in whitelisting and approval mechanisms, designed for AI assistants like Roo Code and Claude Desktop.

How to use Mac Shell MCP Server?

Install by cloning the repository and running npm install && npm build, or use npx directly from the GitHub repository. Configure the server in your MCP client settings (Roo Code or Claude Desktop), then invoke tools such as execute_command or get_whitelist to run and manage shell commands.

Key features of Mac Shell MCP Server

Execute macOS terminal commands through MCP
Three security levels: safe, requires approval, forbidden
Pre-configured whitelist with common safe commands
Approval workflow for potentially dangerous commands
Tools to manage whitelist and pending approvals

Use cases of Mac Shell MCP Server

AI-assisted file browsing and directory listing
Safe execution of read-only commands (ls, cat, grep)
Controlled file operations with approval (cp, mv, mkdir)
Blocking dangerous commands like rm and sudo

FAQ from Mac Shell MCP Server

What commands are safe by default?

Safe commands include ls, pwd, echo, cat, grep, find, cd, head, tail, and wc. These execute without approval.

What commands require approval?

Commands like mv, cp, mkdir, touch, chmod, and chown require explicit approval before execution.

What

Frequently asked questions

What commands are safe by default?

Safe commands include ls, pwd, echo, cat, grep, find, cd, head, tail, and wc. These execute without approval.

What commands require approval?

Commands like mv, cp, mkdir, touch, chmod, and chown require explicit approval before execution.

Comments

Basic information

More Developer Tools MCP servers

Moxie Docs

Jackalope-Dev

Automated codebase documentation for GitHub: searchable docs, MCP context for AI agents, doc drift detection, and Friday Cleanup PRs.

MCP Framework

QuantGeekDev

The Typescript MCP Framework

924

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K

endoflife.ai

Free MCP server for software end-of-life intelligence: EOL dates, support status, and the 0-100 EOL Risk Score across 485 tracked products. Agents can check a single version, pull a product's full lifecycle schedule, or

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