Terminal MCP Server について
Terminal MCP Serverは、Claudeが設定済みディレクトリでターミナルコマンドを実行できるMCPサーバーです。ディレクトリへのアクセス制御と、コマンド実行権限を与える際の注意を説明しています。
主な機能
- 01Claude経由のターミナルコマンド実行
- 02設定済みディレクトリへのアクセス制限
- 03Claude用MCPサーバーとしての設定
活用シーン
- 01Claudeからターミナルコマンドを実行
- 02指定ディレクトリにコマンドアクセスを限定
MCP 対応
ClaudeなどのMCPクライアントにターミナルコマンド実行機能を提供します。アクセス範囲は設定されたディレクトリに限定されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ターミナル MCP サーバー
このリポジトリには、ターミナルコマンド用の Model Context Protocol(MCP)サーバー実装が含まれています。
セットアップ手順
前提条件
- Node.js(v16 以上)
- npm(v7 以上)
ローカルセットアップ
- リポジトリをクローンします。
git clone https://github.com/algae514/terminal-mcp-server.git
cd terminal-mcp-server
- 依存関係をインストールします。
npm install
- プロジェクトをビルドします。
npm run build
- 起動スクリプトを実行可能にします。
chmod +x start-server.sh
設定
このサーバーを Claude で使用するには、ターミナル MCP サーバーを含めるように Claude の設定を更新する必要があります。
Claude の設定ファイル(通常は ~/.config/claude/claude_desktop_config.json などにあります)を更新し、以下を追加します。
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/directory1",
"/path/to/directory2",
"/path/to/directory3"
]
},
"terminal": {
"command": "/path/to/terminal-mcp-server/start-server.sh",
"args": []
}
}
}
/path/to/directory1、/path/to/directory2 などを、Claude からアクセスできるようにするディレクトリに置き換えます。
/path/to/terminal-mcp-server を、このリポジトリをクローンした実際のパスに置き換えます。
使用方法
設定が完了すると、Claude はターミナル MCP サーバーを通じて、指定されたディレクトリ内でターミナルコマンドを実行できます。
セキュリティに関する考慮事項
- ターミナルでディレクトリ内のコマンドを実行できるようにするには、maven-tool.json ファイルに場所を指定する必要があります。サンプル URL が用意されています。
- Claude がこれらの場所でコマンドを実行できるようになるため、公開するディレクトリには注意してください。
- サーバーの実行には、権限を制限した専用ユーザーの使用を検討してください。
- Claude が実行したコマンドを確認し、安全かつ適切であることを確かめてください。
ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。