g0t4/mcp-server-commands

Overview

This is a Model Context Protocol server that exposes a single tool, runProcess, for executing arbitrary shell commands. It receives commands via MCP requests and runs them on the local machine, returning stdout, stderr, and exit codes. The implementation is written in TypeScript and relies on the standard MCP SDK.

Best for

Best for
Developers who need to run shell commands from MCP-enabled AI assistants in trusted, local environments.

Use cases

• Execute build scripts or tests from an MCP host
• Run system administration commands through an MCP client
• Integrate custom CLI tools into AI-assisted workflows

How to use

Install

uvx mcpo --port 3010 --api-key "supersecret" -- npx mcp-server-commands

Tools exposed

• run_process

Tested with

Claude Desktop

Notes

This is a Model Context Protocol server that exposes a single tool, runProcess, for executing arbitrary shell commands. It receives commands via MCP requests and runs them on the local machine, returning stdout, stderr, and exit codes. The implementation is written in TypeScript and relies on the standard MCP SDK.

226 stars on GitHub. Last updated 2026-05-12. Licensed MIT.

Use cases

• Execute build scripts or tests from an MCP host
• Run system administration commands through an MCP client
• Integrate custom CLI tools into AI-assisted workflows

Pros

• Simple and direct execution of shell commands
• Works with any MCP compatible host or client
• Lightweight and easy to install from npm

Cons

• No sandboxing or permission model for executed commands
• Poses significant security risks if exposed to untrusted users
• Limited to local machine execution with no remote support

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.