AcademyMCP serversDevelopment

mcp-shell

Development and IT teams that want an AI assistant to work with files and git under clear limits.

  • Recommendedour rating
  • 108gitHub stars
  • GPL-3.0licence
  • 15 days agolast update
claude mcp add shell -e MCP_SHELL_LOG_LEVEL=info -- docker run --rm -i sonirico/mcp-shell:latest

What it does

An MCP server written in Go that gives an AI assistant controlled access to your machine. By default it runs in secure mode with typed tools for file reads, search and git inspection, confined to a working directory. Running raw shell commands requires an explicit opt-in, and a YAML file sets the policy.

Use cases

  1. 01Let an assistant read and search project files
  2. 02Inspect git history from an AI client
  3. 03Run approved scripts in a Docker sandbox

Questions about
mcp-shell.

What is mcp-shell used for?

Development and IT teams that want an AI assistant to work with files and git under clear limits. An MCP server written in Go that gives an AI assistant controlled access to your machine. By default it runs in secure mode with typed tools for file reads, search and git inspection, confined to a working directory. Running raw shell commands requires an explicit opt-in, and a YAML file sets the policy.

How do I install mcp-shell?

Run this in your terminal: claude mcp add shell -e MCP_SHELL_LOG_LEVEL=info -- docker run --rm -i sonirico/mcp-shell:latest

Is mcp-shell open source?

Yes. The code is on GitHub (sonirico/mcp-shell) under the GPL-3.0 licence.

Is mcp-shell safe to use?

It passed our automatic scan for credential theft, hidden instructions and risky install commands. Third party open source software. Sabemos AI does not maintain it. Check the code and permissions before you connect it to company data.