Executes shell commands via the Model Context Protocol (MCP) enabling safe execution of shell commands by AI agents.
Most developer tooling work still happens through a UI a human drives. Shell Server MCP server moves it into the conversation instead. Executes shell commands via the Model Context Protocol (MCP) enabling safe execution of shell commands by AI agents.
A server that uses the Model Context Protocol (MCP) to execute shell commands. It functions as a bridge that allows AI agents to safely execute shell commands.
The server publishes 6 tools. What each one is for:
shell_exec — The shell_exec tool exposed by this serverhostname — The hostname tool exposed by this serverplatform — The platform tool exposed by this servershell — The shell tool exposed by this serverusername — The username tool exposed by this serverLogging — The Logging tool exposed by this serverInstallation goes through your MCP client rather than a global install: point it at @mkusaka/mcp-shell-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Shell Server's toolset — shell_exec, hostname, platform and 3 more — is a fair guide to whether it matches your workflow. It is maintained by mkusaka; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Shell Server's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| shell_exec | The shell_exec tool exposed by this server. |
| hostname | The hostname tool exposed by this server. |
| platform | The platform tool exposed by this server. |
| shell | The shell tool exposed by this server. |
| username | The username tool exposed by this server. |
| Logging | The Logging tool exposed by this server. |
{
"mcpServers": {
"shell": {
"command": "npx",
"args": ["-y", "@mkusaka/mcp-shell-server"]
}
}
}Configuration as documented by the project. Restart the client after saving.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.