mcp-server-commands

ツール

ツールはLLMがリクエストするためのものです。Claude Sonnet 3.5はrun_commandインテリジェントに使用します。また、初期テストでは、MCPおよびllama4モデルを使用したGroq Desktopで有望な結果が得られました。

現在、すべてを制御するコマンドは 1 つだけです。

• run_command - コマンドを実行します。例: hostname 、 ls -al 、 echo "hello world"など
  • STDOUTとSTDERRテキストとして返します
  • オプションのstdinパラメータは、LLMが
    • fish 、 bash 、 zsh 、 pythonなどのコマンドにstdinのコードを渡す
    • stdinのテキストからcat >> foo/bar.txtでファイルを作成する

[!警告] このサーバーに実行させるコマンドには注意してください。Claudeデスクトップアプリでは、「 Allow for This Chat 」ではなく「 Approve Onceを使用して各コマンドを承認し、信頼できないコマンドはDeny使用してください。権限はサーバーを実行するユーザーによって決定されます。sudo sudo実行しないでください。

ビデオウォークスルー

プロンプト

プロンプトは、ユーザーがチャット履歴に含めることができるもので、 Zedのスラッシュ コマンド (AI チャット パネル内) を通じて表示されます。

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

発達

依存関係をインストールします:

サーバーを構築します。

自動リビルドを使用した開発の場合:

インストール

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 に公開されました

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

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

ログ記録

Claude デスクトップ アプリは~/Library/Logs/Claude/mcp-server-mcp-server-commands.logにログを書き込みます。

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

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

デバッグ

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

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