Windows Command Line MCP Server

Windows Command Line MCP Server

AI モデルが Windows のコマンドライン機能を安全かつ効率的に利用できるようにする、安全な Model Context Protocol（MCP）サーバーです。

概要

Windows Command Line MCP Server は、AI モデルと Windows システムの操作をつなぐ、堅牢で安全なブリッジを提供します。厳格なセキュリティプロトコルを維持しながら、コマンドの制御された実行、プロジェクトの作成、システム情報の取得を可能にします。

主な機能

🔒 セキュリティの強化

• 包括的なコマンド許可リスト
• 厳格な入力検証
• 破壊的なシステム操作の防止
• 設定可能なセキュリティレベル

🛠 開発ツールのサポート

• React、Node.js、Python のプロジェクト作成
• 安全な開発環境での操作
• 開発ワークフロー向けに拡張されたコマンドサポート

🖥 システム操作機能

• Windows CLI コマンドの実行
• PowerShell スクリプトの実行
• システム情報とネットワーク情報の取得
• プロセスとサービスの管理

インストール

Smithery 経由でのインストール

Smithery 経由で Windows Command Line MCP Server を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

前提条件

• Node.js 16 以降
• npm または yarn
• Windows オペレーティングシステム

セットアップ

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git
cd Windows-Command-Line-MCP-Server
npm install
npm run build

使用方法

コマンドラインオプション

• デフォルトモード：あらかじめ定義された安全なコマンドを使用します
• --allow-all：拡張モードで実行します（追加の予防措置が適用されます）
• カスタムコマンドリストを引数として指定できます

プロジェクトの作成

組み込みのプロジェクト作成ツールを使って、新しいプロジェクトを安全に作成できます：

• 対応するプロジェクトタイプ：React、Node.js、Python
• プロジェクトはサンドボックス化された ~/AIProjects ディレクトリに作成されます

利用可能なツール

1. execute_command：Windows CLI コマンドを実行します
2. execute_powershell：PowerShell スクリプトを実行します
3. create_project：新しい開発プロジェクトを安全に作成します
4. list_running_processes：アクティブなシステムプロセスを取得します
5. get_system_info：システム構成の詳細を収集します
6. get_network_info：ネットワークアダプターの情報を取得します
7. get_scheduled_tasks：システムタスクの一覧表示と照会を行います
8. get_service_info：Windows サービスの管理と照会を行います
9. list_allowed_commands：サーバーで実行できるすべてのコマンドを一覧表示します

Claude for Desktop での使用

このサーバーを Claude for Desktop で使用するには：

1. 上記のセットアップ手順に従ってサーバーをビルドします
2. claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

/path/to/dist/index.js を、dist ディレクトリにあるビルド済み index.js ファイルの絶対パスに置き換えてください。

3. Claude for Desktop を再起動します
4. Claude に Windows のシステム操作を依頼すると、ツールを使用できます

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

許可されるコマンド

デフォルトでは、安全なコマンドのみが許可されます：

• システム情報の取得
• ネットワーク構成
• プロセス管理
• 開発ツールの操作

ブロックされる操作

以下を含む危険なコマンドは、常にブロックされます：

• ディスクのフォーマット
• ユーザー管理
• システムのシャットダウン
• 重要なレジストリの変更

設定

許可するコマンドを指定するか、設定フラグを使ってサーバーの動作をカスタマイズできます。

例

# Run with default safe commands
node dist/index.js

# Run with specific allowed commands
node dist/index.js dir echo npm git

# Run in extended mode (use with caution)
node dist/index.js --allow-all

コントリビューション

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルをご覧ください。

謝辞

• Model Context Protocol の仕様に着想を得ています
• セキュリティと柔軟性を考慮して開発されています

バージョン履歴

• 0.3.0: README に記載されているすべてのツールを実装（システム情報、ネットワーク情報、プロセス管理、サービス情報）
• 0.2.0: プロジェクト作成機能を追加し、開発ツールを拡充
• 0.1.0: 基本的なコマンド実行機能を備えた初回リリース

サポート

問題、質問、提案がある場合は、GitHub でイシューを作成してください。