# shell MCP server

> Allows an AI client to execute shell commands and manage files through a secure, audited, and tool-based interface.

- Repository: https://github.com/sonirico/mcp-shell
- Page: https://hostedmcp.org/servers/sonirico/mcp-shell
- Transport: —
- Stars: 113
- License: GPL-3.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MCP_SHELL_ALLOW_UNSAFE` | no | no |  |
| `MCP_SHELL_LOG_LEVEL` | no | no |  |
| `MCP_SHELL_SEC_CONFIG_FILE` | no | no |  |

## Tools (29)

- `read_file`
- `list_dir`
- `glob`
- `grep`
- `stat`
- `diff_files`
- `system_info`
- `git_status`
- `git_log`
- `git_diff`
- `git_show`
- `git_blame`
- `git_branches`
- `git_tags`
- `git_rev_parse`
- `git_ls_files`
- `git_stash_list`
- `git_remotes`
- `write_file`
- `edit_file`
- `mkdir`
- `move`
- `delete`
- `git_add`
- `git_commit`
- `git_switch`
- `git_restore`
- `git_stash`
- `run_script`

## FAQ

### Is it safe to run shell commands with this server?

Yes, secure mode is the default, which uses typed tools instead of raw shell strings and confines all paths to a specific working directory.

### Can the AI modify files or use git?

By default, file and git write tools are disabled, but they can be enabled via a YAML configuration file.
