PowerShell MCP Server

PowerShell MCP Server

site icon
2025.04.11 0
TypeScript命令行工具Windows集成开发效率
PowerShell MCP Server 是一个强大的MCP服务器,专为PowerShell命令执行设计,无需特殊字符限制。它提供了Claude或其他MCP兼容AI助手与PowerShell、CMD、Git Bash等Windows命令行界面的集成,解决了特殊字符处理的常见问题。
View on GitHub

Overview

基本能力

产品定位

PowerShell MCP Server 是一个专为Windows命令行环境设计的MCP服务器,旨在提供无限制的命令执行能力,特别适用于需要处理特殊字符的场景。

核心功能

  • 完整的Windows shell环境访问(PowerShell、CMD、Git Bash)
  • 无命令或参数限制
  • 完整的文件系统访问
  • SYSTEM级服务安装
  • 自动服务恢复
  • 网络绑定控制
  • 进程重用以提高性能
  • 长时间运行操作的扩展超时

适用场景

  • 需要无限制执行PowerShell命令的开发环境
  • 需要处理特殊字符(如管道、重定向等)的自动化脚本
  • 需要系统级权限的管理任务

工具列表

  • install-service.ps1: 安装服务脚本
  • uninstall-service.ps1: 卸载服务脚本
  • config.json: 配置文件,用于设置安全选项和shell配置

常见问题解答

问题: 特殊字符权限错误 解决方案: 在config.json中设置enableInjectionProtectionfalse,并为每个shell显式设置空的blockedOperators数组。

使用教程

使用依赖

  • Node.js环境
  • Windows操作系统

安装教程

  1. 构建项目:
npm install
npm run build
  1. 将构建的文件复制到Windows机器
  2. 以管理员身份运行安装脚本:
.\install-service.ps1

调试方式

  • 检查服务是否正常运行
  • 测试包含特殊字符的命令,如Get-Process | Select-Object -First 5
  • 查看日志文件以排查问题

配置提示

启用完整命令执行

  1. 设置security.enableInjectionProtectionfalse
  2. 为所有shell设置空的blockedOperators数组

平衡安全与功能

  • 在生产环境中保持enableInjectionProtection启用
  • 使用不包含特殊字符的单独命令
  • 实施适当的网络级安全控制

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。