mcp-server-commands

ツール

ツールはLLMがリクエストするためのもので、例えばClaudeデスクトップアプリなどがあります。Claude Sonnet 3.5は両方のツールをインテリジェントに活用しており、大変驚きました。

• run_command - コマンドを実行します。例: hostname 、 ls -al 、 echo "hello world"など
  • STDOUTとSTDERRをテキストとして返します
• run_script - スクリプトを実行します。(例: fish 、 bash 、 zsh 、 python )
  • LLM が書き込んだコードを実行してみましょう。
  • スクリプトはSTDIN経由で渡されます
  • run_script == run_command + STDIN経由のスクリプト
  • Claude は、これに関して非常に創造的です。つまり、 catインタープリターとして使用して新しいファイルを作成します。

[!警告] このサーバーに実行させるコマンドには注意してください。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

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

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

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

ログ記録

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 を提供します。