GP

gunjanjp/powershell-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

27 stars 8 forks Качество 66 Тренд 11MIT

PowerShell MCP сервер

Обзор

Комплексный сервер Model Context Protocol (MCP), который позволяет Claude и другим приложениям LLM выполнять команды PowerShell, скрипты и выполнять системные операции в системах Windows. - Выполнять команды, запускать скрипты и создавать новые файлы PowerShell - : Получать системную информацию, контролировать процессы, проверять службы и дисковое пространство - : Список каталогов, получать информацию о файлах и искать файлы с сопоставлением шаблонов - : Установка по одной команде с автоматической конфигурацией Claude Desktop - : Безопасное выполнение с надлежащей обработкой ошибок и управлением сессиями - execution-powershell - Исполнить команды PowerShell с дополнительным рабочим каталогом - execution-powershell-script - Run PowerShell script files with parameters - create-powershell-script - Create new PowerShell scripts - get-system-info - Всеобъемлющая системная информация Windows - get-process-list - Запуск процессов с использованием ЦП/памяти (сортируемый/фильтровываемый) - get-service-status - Статус служб Windows с фильтрацией - check-disk-space - Disk...

Обзор (машинный перевод)

Комплексный сервер Model Context Protocol (MCP), который позволяет Claude и другим приложениям LLM выполнять команды PowerShell, скрипты и выполнять системные операции в системах Windows.

** Основные характеристики **

PowerShell Execution: Исполнять команды, запускать скрипты и создавать новые файлы PowerShell ️️ Системный мониторинг: Получите информацию о системе, отслеживайте процессы, проверяйте службы и дисковое пространство ** s Операции с файлами**: каталоги списков, информация о файлах и файлы поиска с сопоставлением шаблонов

  • ️️Простая настройка: однокомандная установка с автоматической конфигурацией Claude Desktop :️ Безопасно: Безопасное выполнение с надлежащей обработкой ошибок и управлением сеансами

s️ ** Доступные инструменты**

###Инструменты PowerShell

  • execute-powershell - Исполнять команды PowerShell с дополнительным рабочим каталогом
  • execute-powershell-script - Запуск файлов сценариев PowerShell с параметрами create-powershell-script - Создание новых сценариев PowerShell

Системные инструменты

get-system-info - Всеобъемлющая системная информация Windows

  • get-process-list - Запуск процессов с использованием CPU/памяти (сортируемый/фильтрируемый) get-service-status — статус служб Windows с фильтрацией

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Открыть полный README на GitHub

Установка

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": {} } } }