MCP Terminal Server

MCP Terminal Server

MCP Terminal Server は、すっきりとしたウェブインターフェースを通じて、ターミナルへのアクセスとシステムツールを提供します。シンプルな HTTP サーバーを介して、リモートでのコマンド実行、ディレクトリ一覧の表示、その他のターミナル操作が可能です。

機能

• 🚀 リモートターミナルアクセス：ウェブブラウザーからシェルコマンドを実行
• 📁 ディレクトリ一覧：任意のディレクトリ内のファイルを参照、一覧表示
• 🔒 安全なローカルインストール：root 権限なしで実行
• 🌐 ウェブインターフェース：簡単に操作できる、すっきりとしたモダンな UI
• 🔄 リアルタイム更新：コマンドの出力をリアルタイムで確認
• 🛠️ 簡単な管理：サーバーの起動、停止、管理を行うシンプルなコマンド

前提条件

MCP Terminal Server をインストールする前に、お使いのシステムが次の要件を満たしていることを確認してください。

• Node.js（バージョン 14 以上）
• curl（インストールスクリプトのダウンロード用）
• tar（パッケージの展開用）

クイックインストール

次のコマンドを 1 つ実行して、MCP Terminal Server をインストールします。

curl -o- https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh | bash

これにより、次の処理が行われます。

1. インストールスクリプトをダウンロードします
2. 依存関係を確認します
3. サーバーファイルをダウンロードして展開します
4. 必要なディレクトリを設定します
5. コマンドを PATH に追加します

手動インストール

実行前にスクリプトの内容を確認する場合は、次の手順に従ってください。

1. インストールスクリプトをダウンロードします。

   curl -o install-mcp.sh https://github.com/Yaswanth-ampolu/smithery-mcp-server/raw/main/main/install-mcp.sh
   

2. スクリプトの内容を確認します。

   less install-mcp.sh
   

3. インストールを実行します。

   bash install-mcp.sh
   

使用方法

インストール後は、次のコマンドで MCP Terminal Server を管理できます。

サーバーの起動

mcp-terminal start

デフォルトでは、サーバーはポート 8080 で起動します。別のポートを使用するには、次のようにします。

mcp-terminal start --port 9000

サーバーの停止

mcp-terminal stop

サーバーのステータス確認

mcp-terminal status

次の情報が表示されます。

• サーバーが実行中かどうか
• 実行中のサーバーの PID
• メモリー使用量
• ウェブインターフェースにアクセスするための URL

サーバーの再起動

mcp-terminal restart

アンインストール

MCP Terminal Server を完全に削除するには、次のようにします。

mcp-terminal uninstall

ウェブインターフェース

サーバーの起動後、次の URL からウェブインターフェースにアクセスできます。

http://localhost:8080

（または、指定したカスタムポート）

ウェブインターフェースでは、次の操作ができます。

• コマンド実行ツール
• ディレクトリ一覧ツール
• リアルタイムの出力表示

設定

MCP Terminal Server のファイルは、次の場所に保存されます。

• ~/mcp-terminal - メインのインストールディレクトリ
• ~/bin/mcp-terminal - コマンドスクリプト

ログファイルと PID 情報は、次の場所に保存されます。

• ~/mcp-terminal/mcp.log - サーバーのログファイル
• ~/mcp-terminal/mcp.pid - サーバーの PID ファイル

トラブルシューティング

サーバーが起動しない

サーバーが起動しない場合は、次の手順を試してください。

1. Node.js がインストールされており、バージョンが 14 以上であることを確認します。

   node -v
   

2. ログファイルでエラーを確認します。

   tail -n 50 ~/mcp-terminal/mcp.log
   

3. インストールディレクトリが存在することを確認します。

   ls -la ~/mcp-terminal
   

ポートがすでに使用中

デフォルトのポート（8080）がすでに使用されている場合は、次のようにします。

mcp-terminal start --port 9000

コマンドが見つからない

mcp-terminal コマンドが見つからない場合は、次の手順を試してください。

1. ~/bin が PATH に含まれていることを確認します。

   echo $PATH
   

2. 含まれていない場合は、手動で追加します。

   export PATH="$HOME/bin:$PATH"
   

3. 恒久的に追加するには、シェル設定に追記します。

   echo 'export PATH="$HOME/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc
   

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

• MCP Terminal Server は、起動したユーザーと同じ権限でコマンドを実行します
• サーバーはローカルネットワーク上、またはファイアウォールの内側で実行することをおすすめします
• 外部に公開する環境では、認証機能を備えたリバースプロキシの使用を検討してください

ライセンス

MIT ライセンス

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

サポート

問題、質問、フィードバックについては、GitHub リポジトリで issue を作成してください。