MCP.so
Sign In

Mac Shell MCP Server

@cfdude

RepositoryHomepage

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

Basic information

Category

Developer Tools

License

MIT

Runtime

node

Transports

stdio

Publisher

cfdude

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

Comments

More Developer Tools MCP servers

JetBrains MCP Proxy Server

JetBrains

A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio

962

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K

Test

x1xhlol

FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae, Traycer AI, VSCode Agent, Warp.dev, Windsurf, Xcode, Z.ai Code, Dia & v0. (And other Open Sou

141.7K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K