MCP Server Commands

🚀 ツール

このツールは、LLMs（大規模言語モデル）のリクエストに使用されるもので、Claude デスクトップアプリケーションです。Claude Sonnet 3.5 がこの 2 つのツールを賢く使えることに、私はとても驚きました。

• 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 デスクトップアプリケーションでは、Approve Once（Allow for This Chat ではなく）を使用して、コマンドを 1 つずつ確認できるようにしてください。コマンドが信頼できない場合は、Deny を使用してください。 権限はサーバーを実行するユーザーによって決まります。 sudo で実行しないでください。

🎥 ビデオデモ

💡 ヒント

ヒントは、ユーザーがチャット履歴に含める内容で、Zed のコマンド（その AI チャットパネル内）を通じて使用されます。

• run_command - コマンド出力付きのメッセージを生成します。

🛠️ 開発

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築を使用した開発

npm run watch

📦 インストール

Claude デスクトップと一緒に使用するには、サーバー設定を追加してください。

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

公開された npm パッケージの使用

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

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

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

{
  "mcpServers": {
    "mcp-server-commands": {
      // これは index.js の shebang のためです
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

📝 ログ記録

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

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

ちなみに、ログは STDERR を通じて書き込まれます。これは、Claude デスクトップアプリケーションがログファイルにルーティングする内容だからです。 将来的には、整形されたログメッセージが STDIO を通じて MCP クライアント（Claude デスクトップアプリケーションではないことに注意）に書き込まれることが期待されます。

🐞 デバッグ

MCP サーバーは stdio を通じて通信するため、デバッグは難しい場合があります。MCP Inspector を使用することをおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

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