MCP Powershell Server

MCP PowerShell服务器

用于在Windows上执行PowerShell命令的内存优化MCP服务器。

为什么存在

创建此服务器是为了解决一个常见的Windows开发问题：许多AI编码助手（如Claude Code）试图通过Bash在Windows上执行PowerShell命令，但由于Bash不理解PowerShell语法而失败。此服务器通过适当的引用、路径处理和内存优化提供直接的PowerShell执行。

而不是与Bash翻译层斗争或不断提醒AI使用 cmd.exe，此MCP服务器为AI助手提供了对PowerShell的直接、可靠访问，以及他们所需的所有Windows特定功能。

特性

• 仅使用-EncodedCommand执行PowerShell，以实现可靠的引用
• 内存优化，默认输出限制为64KB，最大2MB
• 基于缓冲区的输出处理，防止内存泄漏
• 使用taskkill/t/f杀死进程树
• 超时保护（默认60秒，最长10分钟）
• 跨平台MCP客户端兼容性

安装

npm install

用法

启动服务器

node mcp-shell-server.mjs

使用MCP客户端进行配置

添加到您的MCP客户端配置中（例如，Gemini CLI settings.json）：

{
  "mcpServers": {
    "mcp-powershell-server": {
      "command": "node",
      "args": ["path/to/mcp-shell-server/mcp-shell-server.mjs"],
      "env": {
        "MCP_SHELL_EXE": "pwsh.exe"  // Optional: override shell executable
      }
    }
  }
}

工具：run_shell_command

执行具有内存和超时保护的PowerShell命令。

参数

• command （必需）：要执行的PowerShell命令/脚本
• cwd （可选）：工作目录
• timeoutMs （可选）：超时（毫秒）（最多10分钟）
• maxOutputBytes （可选）：每个流的最大输出字节数（默认64KB，最大2MB）

响应

{
  "stdout": "...",
  "stderr": "...",
  "exitCode": 0,
  "signal": null,
  "truncated": false,
  "timedOut": false,
  "platform": "win32",
  "shell": "pwsh.exe"
}

例子

列出文件

{
  "command": "Get-ChildItem -Path ."
}

获取系统信息

{
  "command": "Get-ComputerInfo"
}

具有自定义超时和输出限制

{
  "command": "Get-Process",
  "timeoutMs": 30000,
  "maxOutputBytes": 128000
}

内存优化

• 默认输出限制：每个流64KB
• 最大输出限制：每个流2MB
• 缓冲区块而不是字符串连接
• 自动清理事件侦听器
• 进程树在超时/截断时终止

安全说明

• 命令以用户权限运行
• MCP命令绕过PowerShell执行策略
• 考虑实施命令白名单以供生产使用
• 如果需要，使用工作目录限制

环境变量

• MCP_SHELL_EXE：覆盖PowerShell可执行文件（pwsh.exe或PowerShell.exe）
• 标准环境变量传递给子进程

需求

• Node.js 18+
• Windows操作系统
• PowerShell（建议使用pwsh.exe）

许可证

麻省理工学院