Bash MCP（マスターコントロールプログラム）
Claude がセキュリティ対策を講じた上で安全に bash コマンドを実行できるようにする TypeScript アプリケーションです。このプロジェクトは、Model Context Protocol (MCP) を実装し、Claude のような AI アシスタントから bash コマンドを実行するための安全なインターフェースを提供します。
特徴
- 制御された環境でbashコマンドを実行する
- ステートレスとステートフル（対話型）の両方のコマンド実行をサポート
- セキュリティ対策:
- ホワイトリストに登録されたコマンド
- ホワイトリストに登録されたディレクトリ
- コマンド検証
- 出力のサニタイズ
- 対話型コマンドのセッション管理
- 包括的なログ記録
- AI統合のためのMCPサーバー実装
インストール
npm install
npm run build
構成
設定はconfig/default.jsonに保存されます。以下の項目をカスタマイズできます。
- 許可されたコマンド
- 許可されたディレクトリ
- セッション設定
- セキュリティ設定
- ログ設定
構成例:
{
"allowedCommands": ["ls", "cat", "echo", "pwd"],
"allowedDirectories": ["/tmp", "/home"],
"session": {
"timeout": 300,
"maxActiveSessions": 5,
"defaultMode": "stateless"
},
"security": {
"validateCommandsStrictly": true,
"sanitizeOutput": true,
"maxOutputSize": 1048576,
"commandTimeout": 30
},
"logging": {
"level": "info",
"file": "logs/bash-mcp.log",
"maxSize": 10485760,
"maxFiles": 5
}
}
使用法
図書館として
シンプルなコマンド実行
import { executeCommand } from 'bash-mcp';
const result = await executeCommand('ls -la', { cwd: '/home/user' });
console.log(result.output);
インタラクティブセッション
import { initBashMCP } from 'bash-mcp';
const mcp = await initBashMCP();
// Create a session
const session = mcp.createSession('/home/user');
const sessionId = session.sessionId;
// Execute a command in the session
const result1 = await mcp.executeCommand('ls -la', { sessionId });
console.log(result1.output);
// Send input to the session
const result2 = await mcp.sendInput({ sessionId, input: 'echo "Hello, world!"' });
console.log(result2.output);
// Close the session when done
mcp.closeSession(sessionId);
MCPサーバーとして
このプロジェクトには、Claude Desktop またはその他の MCP クライアントで使用できる MCP サーバー実装が含まれています。
# Start the TypeScript MCP server
npm run mcp
# Start the JavaScript MCP server
npm run mcp-js
# Start with MCP Inspector
npm run inspector
MCP サーバーの実装に関する詳細なドキュメントについては、 MCP.md参照してください。
セキュリティに関する考慮事項
この MCP はセキュリティを考慮して設計されていますが、次の点が重要です。
- 許可されたコマンドとディレクトリのリストを可能な限り制限する
- 定期的に構成を確認し更新する
- ログを監視して不審なアクティビティがないか確認する
- MCPとその依存関係を最新の状態に保つ
発達
建物
リンティングとフォーマット
リンティングの問題を確認するには:
リンティングとフォーマットの問題を自動的に修正するには:
または手動で:
npm run lint:fix # Fix linting issues
npm run format # Format code
テスト
MCP SDKバージョン
このプロジェクトでは、MCP SDK バージョン 1.0.1 を使用します。