mcp-server-commands

runProcess ツール

runProcess ツールは、ホストマシン上でプロセスを実行します。呼び出し方法には、相互に排他的な2つの方法があります。

1. command_line (文字列) — システムのデフォルトシェル経由で実行されます（bash/fish/pwshなどに直接入力するのと同じです）。パイプ、リダイレクト、変数展開などのシェル機能がすべて動作します。

2. argv (文字列配列) — 直接実行可能ファイルとして呼び出されます。argv[0] が実行可能ファイルで、残りが引数となります。シェルによる解釈は行われません。

両方を同時に渡すことはできません。ツールは、提供されたパラメータからどちらのシェルを使用するかを推測します。

モデルにシステム上の特定のシェルを使用させたい場合は、システムプロンプトにリストアップすることをお勧めします。あるいはツール命令に含めることもできますが、モデルはシステムプロンプト内の例により注意を払う傾向があります。

問題が発生した場合はお知らせください！

Related MCP server: buildkite-mcp-server

ツール

ツールはLLMが要求するためのものです。Claude Sonnet 3.5はrun_processをインテリジェントに使用します。また、初期テストではGroq Desktop with MCPとllama4モデルで有望な結果が得られています。

現在は、すべてを統括する1つのコマンドのみです！

• run_process - コマンドを実行します（例: hostname、ls -al、echo "hello world"など）

  • STDOUTとSTDERRをテキストとして返します

  • オプションのstdinパラメータを使用すると、LLMは以下のことが可能です

    • fish、bash、zsh、pythonなどのコマンドにSTDIN経由でスクリプトを渡す

    • stdinのテキストからcat >> foo/bar.txtでファイルを作成する

[!WARNING] このサーバーに実行させるコマンドには注意してください！ Claude Desktopアプリでは、「このチャットで許可」ではなく「一度だけ承認」を使用し、各コマンドを確認できるようにしてください。信頼できないコマンドには「拒否」を使用してください。 権限はサーバーを実行するユーザーによって決定されます。 sudoで実行しないでください。

ビデオウォークスルー

プロンプト

プロンプトは、ユーザーがチャット履歴に含めるためのものです（例: Zedのスラッシュコマンド（AIチャットパネル内）経由）

• run_process - コマンド出力を含むプロンプトメッセージを生成します

• 参考：これは主に学習用エクササイズでした... 私はこれをユーザーが要求するツール呼び出しとして見ています。これは、コマンドを実行してその出力をモデルに渡すためのテンプレートであるという、少し大げさな言い方です！

開発

依存関係のインストール:

npm install

サーバーのビルド:

npm run build

自動リビルド付きの開発:

npm run watch

インストール

Claude Desktopで使用するには、サーバー設定を追加します:

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

Groq Desktop (ベータ版, macOS) は ~/Library/Application Support/groq-desktop-app/settings.json を使用します

公開されたnpmパッケージを使用する

このワークフローを使用してmcp-server-commandsとしてnpmに公開されています

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"]
    }
  }
}

ローカルビルドを使用する (リポジトリのチェックアウト)

必ず npm run build を実行してください

{
  "mcpServers": {
    "mcp-server-commands": {
      // works b/c of shebang in index.js
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

ローカルモデル

• ほとんどのモデルは、自分自身でコマンドを実行できるとは考えないようにトレーニングされています。

  • 時には躊躇なくツールを使用することもありますが、そうでない場合は、こちらから促す必要があります。

  • システムプロンプトやプロンプトテンプレートを使用して、ユーザーの要求に従うよう指示してください。これには、再確認なしでrun_processを使用することも含まれます。

• Ollamaは、ローカルでモデルを実行する（Open-WebUIを使用）のに最適な方法です

# NOTE: make sure to review variants and sizes, so the model fits in your VRAM to perform well!

# Probably the best so far is [OpenHands LM](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model)
ollama pull https://huggingface.co/lmstudio-community/openhands-lm-32b-v0.1-GGUF

# https://ollama.com/library/devstral
ollama pull devstral

# Qwen2.5-Coder has tool use but you have to coax it
ollama pull qwen2.5-coder

HTTP / OpenAPI

サーバーはSTDIOトランスポートで実装されています。 HTTPの場合は、OpenAPI互換のWebサーバーインターフェースであるmcpoを使用してください。 これはOpen-WebUIで動作します

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

# uvx runs mcpo => mcpo run npx => npx runs mcp-server-commands
# then, mcpo bridges STDIO <=> HTTP

[!WARNING] open-webuiでmcpoを少し使用しましたが、セキュリティ上の懸念がないか確認してください。

ログ

Claude Desktopアプリはログを ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log に書き込みます

デフォルトでは、重要なメッセージ（エラーなど）のみが記録されます。 より多くのメッセージを表示したい場合は、サーバー設定時にargsに--verboseを追加してください。

ちなみに、ログはSTDERRに書き込まれます。これはClaude Desktopがログファイルにルーティングする先だからです。 将来的には、適切にフォーマットされたログメッセージがSTDIOトランスポート経由でMCPクライアント（Claude Desktopアプリではないことに注意）に書き込まれることを期待しています。

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグは困難な場合があります。パッケージスクリプトとして利用可能なMCP Inspectorの使用をお勧めします:

npm run inspector

Inspectorは、ブラウザでデバッグツールにアクセスするためのURLを提供します。