g0t4/mcp-server-commands

runProcess ツール

runProcessツールはホストマシン上でプロセスを実行します。これを呼び出す方法は2つあります:

1. command_line(文字列)— システムのデフォルトシェルで実行されます(bash/fish]/pwshなどに入力するのと同じです)。パイプ、リダイレクト、変数展開などのシェル機能はすべて動作します。
2. argv(文字列配列) — 直接実行可能な呼び出し。argv[0]は実行可能で、残りは引数です。シェル解釈はありません。

両方を通過することはできません。ツールは、どのパラメータからシェルを使うかを推測します。

もしモデルに特定のシェルをシステム上で使わせたい場合は、システムプロンプトに記載すると良いでしょう。あるいはツールの説明書に記載してもいいかもしれませんが、モデルはシステムプロンプトの例により注意を払う傾向があります。

もし問題があれば教えてください!

道具

ツールはLLMがリクエストするためのものです。Claude Sonnet 3.5は賢くrun_processを使用しています。初期テストでは、MCPおよびllama4モデルを用いたGroq Desktopで有望な結果が示されています。

現在は、すべてを支配するコマンドが一つだけです!

• run_process - コマンドを実行します。例:hostnameやls -al、echo "hello world"など
• テキストとしてSTDOUTおよびSTDERRを返す

runProcess tool

The runProcess tool runs processes on the host machine. There are two mutually exclusive ways to invoke it:

1. command_line (string) — Executed via the system’s default shell (just like typing into bash/fish/pwsh/etc). Shell features like pipes, redirects, and variable expansion all work.
2. argv (string array) — Direct executable invocation. argv[0] is the executable, the rest are arguments. No shell interpretation.

You cannot pass both. The tool infers whether to use a shell from which parameter you provide.

If you want your model to use specific shell(s) on a system, I would list them in your system prompt. Or, maybe in your tool instructions, though models tend to pay better attention to examples in a system prompt.

Let me know if you encounter problems!

Tools

Tools are for LLMs to request. Claude Sonnet 3.5 intelligently uses run_process. And, initial testing shows promising results with Groq Desktop with MCP and llama4 models.

Currently, just one command to rule them all!

• run_process - run a command, i.e. hostname or ls -al or echo "hello world" etc
  • Returns STDOUT and STDERR as text
  • Optional stdin parameter means your LLM can
    • pass scripts over STDIN to commands like fish, bash, zsh, python
    • create files with cat >> foo/bar.txt from the text in stdin

[!WARNING] Be careful what you ask this server to run! In Claude Desktop app, use Approve Once (not Allow for This Chat) so you can review each command, use Deny if you don’t trust the command. Permissions are dictated by the user that runs the server. DO NOT run with sudo.

Video walkthrough

Prompts

Prompts are for users to include in chat history, i.e. via Zed’s slash commands (in its AI Chat panel)

• run_process - generate a prompt message with the command output

• FYI this was mostly a learning exercise… I see this as a user requested tool call. That’s a fancy way to say, it’s a template for running a command and passing the outputs to the model!

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Groq Desktop (beta, macOS) uses ~/Library/Application Support/groq-desktop-app/settings.json

Use the published npm package

Published to npm as mcp-server-commands using this workflow

{
  "mcpServers": {