Remote Command

🚀 リモートコマンドMCPサーバー

このサーバーはModel Context Protocol (MCP) を基に構築されており、異なるオペレーティングシステム間でのリモートコマンド実行をサポートします。統一されたインターフェースを提供してshellコマンドを実行し、WindowsとUnix系システム間のプラットフォーム差異を自動的に処理します。

🚀 クイックスタート

このリモートコマンドMCPサーバーを使用することで、異なるOS間でのコマンド実行が容易になります。以下の手順に従ってサーバーをセットアップしてください。

✨ 主な機能

• クロスプラットフォームのコマンド実行
• WindowsとUnix間のコマンド自動標準化
• 組み込みのエラー処理と詳細なエラーメッセージ
• stdout と stderr を含むレスポンス
• 特定のディレクトリへのコマンド実行制限
• プラットフォームに応じた適切なシェルの選択

📦 インストール

1. プロジェクトコードをダウンロードします。
2. 作業ディレクトリをプロジェクトのルートディレクトリに変更します。
3. 以下のコマンドを実行してインストールします。

npm install

4. 実行可能ファイルを作成します。

npm run build

サーバーの起動

node build/index.js

💻 使用例

基本的な使用法

execute_remote_command は主なツールです。

パラメータ

• command: 実行するコマンド（必須）
• cwd: コマンドを実行する作業ディレクトリ（オプション、デフォルトはカレントディレクトリ）

例

1. Unixシステムで ls を実行するのと同等のWindowsの dir コマンドを実行します。

execute_remote_command({
  command: "list",
  cwd: "."
});

2. .disk ファイルを検索します。

execute_remote_command({
  command: "find . -name '*.disk'",
  cwd: "/home/user"
});

📚 ドキュメント

セキュリティに関する注意事項

⚠️ 重要提示

• cwd を使用してコマンド実行ディレクトリを制限してください。
• 特権昇格コマンドの実行を避けてください。
• MCPサーバーへのアクセス権限を制御してください。
• 敏感な操作を監視してください。

プラットフォームコマンドの処理

コマンド変換

• ls ↔ dir
• cp ↔ copy
• rm ↔ del

シェル

• Windows: cmd.exe
• Unix/Linux: /bin/sh

エラー処理

サーバーは詳細なエラーメッセージを提供し、レスポンスに含まれます。コマンドが失敗した場合、エラーの詳細情報を含むエラーメッセージを受け取ります。

エラーレスポンスの例：

{
  "content": [
    {
      "type": "text",
      "text": "命令執行錯誤：命令以退出代碼 1 失敗"
    }
  ],
  "isError": true
}

開発

プロジェクト構造

remote-command-server/
├── src/
│   └── index.ts    # 主サーバーの実装
├── package.json
├── tsconfig.json
└── README.md

ビルド

npm run build

このコマンドはTypeScriptコードをコンパイルし、build ディレクトリに実行可能ファイルを作成します。

貢献ガイド

1. プロジェクトリポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m '添加一些驚人的功能')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Requestを作成します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。