Windows Command Line MCP Server

by alxspiker
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Git commands for version control within the allowlist of permitted operations

  • Allows project creation and management for Node.js applications in a sandboxed environment

  • Allows execution of npm commands for package management within the security constraints

Windows コマンドライン MCP サーバー

AI モデルが Windows のコマンドライン機能と安全かつ効率的に対話できるようにする、安全なモデル コンテキスト プロトコル (MCP) サーバー。

概要

Windows コマンドライン MCP サーバーは、AI モデルと Windows システム操作の間に堅牢かつ安全なブリッジを提供します。厳格なセキュリティプロトコルを維持しながら、コマンドの実行、プロジェクトの作成、システム情報の取得を制御できます。

主な特徴

🔒 セキュリティ強化

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

🛠 開発ツールのサポート

  • React、Node.js、Python のプロジェクト作成
  • 安全な開発環境のインタラクション
  • 開発ワークフローのコマンドサポートの拡張

🖥 システムインタラクション機能

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

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Windows コマンドライン MCP サーバーを自動的にインストールするには:

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.jsdistディレクトリに構築されたindex.jsファイルへの絶対パスに置き換えます。

  1. デスクトップ版のClaudeを再起動
  2. クロードに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ファイルを参照してください。

謝辞

  • モデルコンテキストプロトコル仕様に触発されて
  • セキュリティと柔軟性を考慮して開発

バージョン履歴

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

サポート

問題、質問、または提案については、GitHub で問題を開いてください。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AI モデルが Windows のコマンドライン機能と安全に対話し、システム コマンド、プロジェクトの作成、システム情報の取得の制御された実行を可能にする、安全なモデル コンテキスト プロトコル サーバー。

  1. Overview
    1. Key Features
      1. 🔒 Enhanced Security
      2. 🛠 Development Tools Support
      3. 🖥 System Interaction Capabilities
    2. Installation
      1. Installing via Smithery
      2. Prerequisites
      3. Setup
    3. Usage
      1. Command Line Options
      2. Project Creation
      3. Available Tools
    4. Using with Claude for Desktop
      1. Security Considerations
        1. Allowed Commands
        2. Blocked Operations
      2. Configuration
        1. Example
      3. Contributing
        1. License
          1. Acknowledgements
            1. Version History
              1. Support
                ID: 976txj1j30