Terminal

🚀 ターミナルMCPサーバ

Claude Desktopを通じてターミナルコマンドを実行するモデルコンテキストプロトコル（MCP）サーバです。このサーバは、ターミナル操作をClaude Desktopと連携して行うことができ、様々なコマンドの実行やディレクトリ操作を支援します。

✨ 主な機能

• パラメータとオプションを持つ任意のターミナルコマンドを実行します。
• 状態を保持しながらディレクトリ間を切り替えることができます。
• ターミナルの環境情報を取得します。
• 完全な出力（stdout、stderr、終了コード）をキャプチャします。
• 適切なエラー処理と整形を行います。

📦 インストール

前提条件

• Node.js v18以上
• TypeScript
• Claude Desktop

インストール手順

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

git clone https://github.com/stat-guy/terminal.git
cd terminal

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

📚 ドキュメント

ローカル開発環境の設定

1. Claude Desktopの設定ファイルを作成または編集します：
   • macOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windowsの場合：%APPDATA%\\Claude\\claude_desktop_config.json

以下の設定を追加します：

{
  "mcpServers": {
    "terminal": {
      "command": "node",
      "args": [
        "[PATH_TO_REPO]/dist/index.js"
      ],
      "env": {
        "PERMISSION_REQUIRED": "true"
      }
    }
  }
}

[PATH_TO_REPO] を実際にクローンしたリポジトリのパスに置き換えてください。

2. Claude Desktopを再起動します。

利用可能なツール

execute_command

• 任意のターミナルコマンドを実行します。
• パラメータとオプションを持つコマンドをサポートします。
• 完全な出力と終了コードをキャプチャします。

change_directory

• 現在の作業ディレクトリを変更します。
• コマンド間で状態を保持します。
• 相対パスと絶対パスをサポートします。

get_current_directory

• 現在の作業ディレクトリのパスを取得します。

get_terminal_info

• ターミナルの環境情報を取得します。
• シェル、ユーザー、プラットフォーム、および最近のコマンド履歴を表示します。

💻 使用例

Claudeにターミナルコマンドを実行させる例を示します：

あなたは私の現在のディレクトリに何があるかを調べてくれますか？
-> 実行：ls -la

あなたは私の現在のディレクトリが何であるかを教えてくれますか？
-> 実行：pwd

あなたはダウンロードフォルダに切り替えることができますか？
-> 実行：cd ~/Downloads

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

• このサーバは、Claude Desktopを通じて明示的なユーザー権限が必要なコマンド実行を行います。
• 環境変数は設定によって制御することができます。
• コマンド実行にはタイムアウトとエラー処理が含まれています。

🔨 開発

1. 変更を監視します：

npm run watch

2. 変更をテストします：

• src/ 内のソースファイルを変更します。
• npm run build を使用して再構築します。
• 変更を読み込むためにClaude Desktopを再起動します。