GP

gunjanjp/powershell-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

27 stars 8 forks 品質 66 トレンド 11MIT

PowerShell MCP サーバー

概要

Claudeや他のLMアプリケーションがPowerShellコマンド、スクリプトを実行し、Windowsシステム上のシステム操作を実行できるようにする、包括的なモデルコンテキストプロトコル(MCP)サーバー。 - : コマンドを実行し、スクリプトを実行し、新しいPowerShellファイルを作成する - : システム情報の取得、システムプロセスの監視、サービスやディスク容量の確認 - : リストディレクトリ、ファイル情報の取得、パターンマッチングでファイル検索 - : 自動Claudeデスクトップ設定でワンコマンドインストール - : 適切なエラー処理とセッション管理で安全な実行 - run-powershell - 任意の作業ディレクトリでPowerShellコマンドを実行します - 実行-powershell-script - パラメータでPowerShellスクリプトファイルを実行 - create-powershell-script - 新しいPowerShellスクリプトを作成します - get-system-info - 包括的なWindowsシステム情報 - get-process-list - CPU/memory使用(sortable/filterable)の実行プロセス - get-service-status - フィルタリング付きのWindowsサービスステータス - check-disk-space - Disk...

概要(AI 翻訳)

Claudeや他のLMアプリケーションがPowerShellコマンド、スクリプトを実行し、Windowsシステム上のシステム操作を実行できるようにする、包括的なモデルコンテキストプロトコル(MCP)サーバー。

✔ キー機能**

-**** PowerShell Execution**: コマンドを実行し、スクリプトを実行し、新しいPowerShellファイルを作成する -緊急時システム監視:システム情報、モニタープロセス、チェックサービス、ディスクスペースの取得

  • 📁 ファイル操作: リストディレクトリ、ファイル情報の取得、パターンマッチングでファイルを検索 -** シンプルなセットアップ**:自動Claudeデスクトップ設定付きワンコマンドインストール
  • ️️ 安全: 適切なエラー処理とセッション管理による安全な実行

́∀`** 利用可能なツール**

パワーシェルツール

  • [execute-powershell - 任意の作業ディレクトリでPowerShellコマンドを実行する
  • [execute-powershell-script - パラメータでPowerShellスクリプトファイルを実行する
  • [create-powershell-script - 新しいPowerShellスクリプトを作成する

システム ツール

  • [get-system-info - 包括的なWindowsシステム情報
  • [[get-process-list] - CPU/メモリ使用(安定/濾過可能)でプロセスを実行
  • [get-service-status - フィルタリングによるWindowsサービスの状態

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

PowerShell MCP Server

A comprehensive Model Context Protocol (MCP) server that enables Claude and other LLM applications to execute PowerShell commands, scripts, and perform system operations on Windows systems.

🌟 Key Features

  • 🔧 PowerShell Execution: Execute commands, run scripts, and create new PowerShell files
  • 🖥️ System Monitoring: Get system info, monitor processes, check services and disk space
  • 📁 File Operations: List directories, get file info, and search files with pattern matching
  • ⚙️ Simple Setup: One-command installation with automatic Claude Desktop configuration
  • 🛡️ Secure: Safe execution with proper error handling and session management

🛠️ Available Tools

PowerShell Tools

  • execute-powershell - Execute PowerShell commands with optional working directory
  • execute-powershell-script - Run PowerShell script files with parameters
  • create-powershell-script - Create new PowerShell scripts

System Tools

  • get-system-info - Comprehensive Windows system information
  • get-process-list - Running processes with CPU/memory usage (sortable/filterable)
  • get-service-status - Windows services status with filtering
  • check-disk-space - Disk space usage for all or specific drives

File Tools

  • list-directory - Enhanced directory listing with filtering
  • get-file-info - Detailed file and directory metadata
  • search-files - Recursive file search with pattern matching

📋 Prerequisites

  • Windows 10/11 or Windows Server 2016+
  • Node.js 18.0.0 or higher
  • PowerShell 5.1+ or PowerShell Core 7+
  • Claude Desktop application

🚀 Quick Setup

# Clone and setup with configuration management
git clone https://github.com/gunjanjp/powershell-mcp.git
cd powershell-mcp
complete-setup.bat

Option 2: Configuration Recovery (If you had existing settings)

# If previous setup overwrote your existing configuration
node recovery.js status      # Check current state
node recovery.js scan        # Find backup configurations
node recovery.js restore 1   # Restore from backup
# OR
node recovery.js merge 1     # Merge backup with current config

Option 3: Manual Setup

# Clone the repository
git clone https://github.com/gunjanjp/powershell-mcp.git
cd powershell-mcp

# Install dependencies
npm install

# Safely add to existing configuration
node recovery.js add-powershell

# Restart Claude Desktop

📖 Usage Examples

Ask Claude:

  • “Execute PowerShell: Get-Date”
  • “Check my system information”
  • “Show me the top 10 processes by CPU usage”
  • “What’s my disk space usage?”
  • “List files in my Downloads folder”
  • “Search for all .txt files in C:\Users”
  • “Create a PowerShell script to backup my Documents folder”

🔧 Commands

Server Commands

# Start the server
npm start

# Test components
npm test

# Run diagnostics
node diagnose.bat
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "powershell": { "command": "node", "args": ["D:/claude/claude-powershell-mcp/src/server.js"], "env": {} } } }