MCP ターミナルサーバー

Name: MCP Terminal Server
Author: RinardNick

モデルコンテキストプロトコル（MCP）を実装した安全なターミナル実行サーバー。このサーバーは、セキュリティ機能とリソース制限を備えた制御されたコマンド実行機能を提供します。

特徴

コマンド実行: 出力キャプチャとエラー処理を備えたシェルコマンドを実行します。
セキュリティ制御: 許可されたコマンドを制限し、コマンドインジェクションを防止する
リソース制御:
- コマンドタイムアウト
- 最大出力サイズの制限
MCP プロトコルサポート:
- 標準MCPメッセージ形式
- 機能広告
- ストリーミング出力のサポート

Related MCP server: Terminal Controller for MCP

発達

ローカルセットアップ

# Clone the repository git clone https://github.com/RinardNick/mcp-terminal.git cd mcp-terminal # Create and activate virtual environment using uv uv venv source .venv/bin/activate # or .venv\Scripts\activate on Windows # Install development dependencies uv pip install -e ".[dev]"

PyPIへの公開

# Build the package uv pip install build python -m build # Upload to PyPI uv pip install twine python -m twine upload dist/*

MCP Inspectorによるテスト

MCP Inspector ツールを使用して、サーバーの実装をテストできます。

# Install inspector npm install -g @modelcontextprotocol/inspector # Test server npx @modelcontextprotocol/inspector python3 src/mcp_terminal/server.py --allowed-commands "python,pip,git,ls,cd"

テストの実行

# Run all tests pytest tests/ # Run specific test file pytest tests/test_terminal.py # Run with coverage pytest --cov=mcp_terminal tests/

Claude Desktopでの使用

パッケージが PyPI に公開されたら:

UV をインストールします(まだインストールされていない場合)。
pip install uv
UV を使用してパッケージをインストールします。
uv pip install mcp-terminal
Claude Desktop を構成する: Claude Desktop 構成ファイルを編集します (通常、macOS では~/Library/Application Support/Claude/claude_desktop_config.jsonにあります)。
{ "mcpServers": { "terminal": { "command": "uv", "args": [ "pip", "run", "mcp-terminal", "--allowed-commands", "python,pip,git,ls,cd", "--timeout-ms", "30000", "--max-output-size", "1048576" ] } } }

プロトコルの実装

サーバーは、次の機能を備えたモデルコンテキストプロトコル (MCP) を実装します。

機能広告

{ "protocol": "1.0.0", "name": "terminal", "version": "1.1.0", "capabilities": { "execute": { "description": "Execute a terminal command", "parameters": { "command": { "type": "string", "description": "The command to execute" } }, "returns": { "type": "object", "properties": { "exitCode": { "type": "number" }, "stdout": { "type": "string" }, "stderr": { "type": "string" }, "startTime": { "type": "string" }, "endTime": { "type": "string" } } } } } }

メッセージ形式

リクエスト：

{ "type": "execute", "data": { "command": "echo 'hello world'" } }

応答：

{ "type": "result", "data": { "command": "echo 'hello world'", "exitCode": 0, "stdout": "hello world\n", "stderr": "", "startTime": "2024-01-20T12:34:56.789Z", "endTime": "2024-01-20T12:34:56.790Z" } }

エラー：

{ "type": "error", "data": { "message": "command not allowed" } }

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

コマンド検証:
- 許可されたコマンドのみ実行できます
- シェル演算子はブロックされています
- コマンドインジェクションの試みは阻止される
資源保護：
- コマンドタイムアウトによりハングアップを防止
- 出力サイズの制限によりメモリ不足を防止
- すべての失敗ケースに対するエラー処理
ベストプラクティス:
- 本番環境では常にallowed-commandsを設定する
- 控えめなタイムアウトとサイズ制限を使用する
- コマンド実行ログを監視する