Terminal MCP Server

🚀 ターミナルMCPサーバー

ターミナルMCPサーバーは、Model Context Protocol (MCP) に基づくサーバーで、リモートまたはローカルでコマンドを実行できます。SSH接続を通じたリモートコマンド実行をサポートし、ローカル環境でもコマンドを実行できます。

英語版ドキュメント

✨ 主な機能

• リモートコマンド実行：SSHプロトコルを通じてリモートデバイスに接続し、コマンドを実行します。
• ローカルコマンド実行：サーバーを起動したローカル環境で直接コマンドを実行します。
• セッション管理：20分間のアクティブセッションを提供し、環境コンテキストの一貫性を維持します。
• 多プラットフォーム対応：Mac、Linuxなどの複数のオペレーティングシステムをサポートします。

📦 インストール

Smitheryを通じたインストール

提供されたリンクを使用して、Smitheryプラットフォーム上でターミナルMCPサーバーを直接インストールします。

手動インストール

1. プロジェクトリポジトリをクローンします：

git clone https://github.com/weidwonder/terminal-mcp-server.git

2. プロジェクトディレクトリに移動し、依存関係をインストールします：

cd terminal-mcp-server
npm install

💻 使用例

サーバーの起動

• ローカルモード（SSHなし）：

node index.js --local

• リモートモード（SSH有効）：

node index.js --ssh

SSH接続

ターゲットデバイスがSSHキー認証で設定されていることを確認してください。デフォルトでは、サーバーは ~/.ssh/id_rsa キーを使用して接続を試みます。

コマンドの実行

ローカル実行

起動したサーバー環境で直接コマンドを実行します：

execute_command --local "your command"

リモート実行

SSH接続されたターゲットデバイス上でコマンドを実行します：

execute_command --ssh <target-host> "your command"

execute_commandツール

パラメータの説明

例

1. ローカルで簡単なコマンドを実行する：

execute_command --local "echo 'Hello, World!'"

2. リモートデバイスで複雑なタスクを実行する：

execute_command --ssh 192.168.1.100 "sudo apt update && sudo apt upgrade"

📚 ベストプラクティス

コマンドの実行

• ターゲットシステムのタイプ（Mac、Linuxなど）に合わせてコマンドを調整します。
• 依存関係の問題を避けるために、完全なパスを使用します。
• 環境を維持する必要がある多段階操作の場合は、&& でコマンドをつなぎます。

SSH接続

• 事前にSSHキー認証を設定してください。
• キーファイルが存在することを確認してください（デフォルト：~/.ssh/id_rsa）。
• リモートデバイス上のSSHサービスが正常に動作していることを確認してください。

セッション管理

• --local または --ssh パラメータを使用して環境コンテキストを維持します。
• 複雑な操作の場合は、環境の一貫性を維持するために同じセッションを維持することをおすすめします。
• 20分間アクティビティがない場合、接続は自動的に切断されます。

📄 注意事項

⚠️ 重要提示

リモートでコマンドを実行する場合は、ターゲットデバイスのセキュリティを確保してください。

⚠️ 重要提示

ローカルまたはリモートコマンドの権限は、サーバーを起動したユーザーおよびSSH接続のユーザーのアイデンティティに依存します。

⚠️ 重要提示

長時間実行されるタスクには、追加のリソース管理と監視が必要になる場合があります。