关键词

AI助手集成PowerShell自动化大语言模型工具系统管理文件管理

项目简介

PowerShell.MCP 是一个创新的工具，它将PowerShell的强大功能与大型语言模型（LLM）的智能结合起来。通过实现Model Context Protocol (MCP)，它允许AI助手在一个持久的、与用户共享的PowerShell控制台中执行各种命令和操作。这使得AI能够利用PowerShell的丰富生态系统，进行系统管理、开发辅助、数据分析等任务，同时用户也能实时查看和协作。

主要功能点

  • 共享控制台体验： AI和用户在同一个PowerShell会话中协作，AI执行的命令实时显示，用户可直接响应AI发起的输入请求。
  • 持久化工作区： 当前目录、导入的模块、变量、函数和认证会话在整个PowerShell会话中保持不变，无需重复初始化。
  • 即时响应，零开销： 命令直接在现有PowerShell进程中执行，避免了每次启动新进程的延迟，输出实时流式传输。
  • 全面的输出捕获： 捕获PowerShell的关键输出流（错误、警告、成功、信息），并返回给AI助手。
  • LLM优化文件操作： 提供专门设计的6个Cmdlet（如'Show-TextFile', 'Add-LinesToFile', 'Update-LinesInFile'等），以1-based行号、自动编码检测和高性能支持AI可靠地处理文本文件。
  • PowerShell管道组合： 允许AI利用PowerShell的管道能力，将简单命令组合成复杂的自动化工作流。
  • 通用模块与CLI工具集成： 将PowerShell的3000+模块以及Git、Docker等任何CLI工具，即时转换为AI可访问的MCP工具。
  • 内置Prompt模板： 提供8个预设的Prompt模板，涵盖开发、分析、管理和学习场景，支持智能自动化。
  • 企业级安全： 仅支持通过命名管道进行本地通信，无网络暴露，所有命令都可见且可审计。

安装步骤

  1. 系统要求： 确保您的系统满足以下条件：
    • Windows 10/11 或 Windows Server 2016+
    • Claude Desktop (推荐) 或其他兼容的MCP客户端
    • PowerShell 7.2.15 或更高版本
    • PSReadLine 2.3.4 或更高版本 (通常自动安装)
  2. 打开PowerShell 7： 按 'Win + R' 键，输入 'pwsh'，然后按 'Enter'。请确保运行的是PowerShell 7.x，而非Windows PowerShell 5.x。
  3. 安装PowerShell.MCP模块： 在PowerShell 7控制台中执行以下命令： 
    Install-Module PowerShell.MCP
Import-Module PowerShell.MCP
  4. 获取模块路径： 执行以下命令获取PowerShell.MCP模块的安装路径，这将在后续配置MCP客户端时使用： 
    (Get-Module PowerShell.MCP).ModuleBase
# 示例输出: C:\Users\YourName\Documents\PowerShell\Modules\PowerShell.MCP\1.2.8

MCP客户端配置示例 (针对 Claude Desktop)

在您的Claude Desktop或其他MCP客户端的配置中，您需要指定MCP服务器的启动命令。以下是一个针对Claude Desktop的JSON配置示例，请根据您实际获取的路径进行修改：

{
  "mcpServers": {
    "PowerShell": {
      "command": "C:\\Users\\YourName\\Documents\\PowerShell\\Modules\\PowerShell.MCP\\1.2.8\\bin\\PowerShell.MCP.Proxy.exe"
      // "command" 的值应替换为您实际的 PowerShell.MCP.Proxy.exe 可执行文件的完整路径。
      // 请注意，JSON字符串中的反斜杠（\）需要用双反斜杠（\\）进行转义。
      // "args": [] // PowerShell.MCP.Proxy.exe 当前无需额外的启动参数。
    }
  }
}

重要提示： 配置完成后，请务必重启您的MCP客户端以激活集成。

基本使用方法

重启客户端后，在您的AI助手中即可直接使用PowerShell功能。您可以尝试以下示例来体验PowerShell.MCP的强大功能：

  • "显示PowerShell.MCP有哪些功能，给我一个生动有趣的演示。"
  • "告诉我当前日期和时间。"
  • "检查PowerShell版本。"
  • "列出消耗内存超过100MB的所有进程。"
  • "分析我的当前项目代码并提出优化建议。"
  • "显示文件 'config.json' 的第5到15行内容。"
  • "在文件 'README.md' 中查找包含 'PowerShell.MCP' 的所有行。"
  • "创建一个新的学习环境来学习Python编程。"

信息

分类

桌面与硬件

访问项目