Terminal MCP Server

ターミナル MCP サーバー

Claude Desktop を通じてターミナルコマンドを実行できる Model Context Protocol（MCP）サーバーです。

機能

• 引数やオプションを指定して、任意のターミナルコマンドを実行
• 状態を維持しながらディレクトリ間を移動
• ターミナル環境の情報を取得
• 出力を完全にキャプチャ（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 に依頼します：

Can you check what's in my current directory?
-> Executes: ls -la

Can you tell me the current directory?
-> Executes: pwd

Can you change to the Downloads folder?
-> Executes: cd ~/Downloads

セキュリティに関する考慮事項

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

開発

1. 変更を監視します：

npm run watch

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

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

プロジェクト構成

/
├── src/
│   └── index.ts    # Main server implementation
├── package.json    # Project configuration and dependencies
├── tsconfig.json  # TypeScript configuration
└── README.md      # This file

コントリビューション

コントリビューションを歓迎します！お気軽に Pull Request を送信してください。

ライセンス

MIT ライセンス