Windows Command Line MCP Server

🚀 Windows命令行MCP服務器

一個安全的模型上下文協議（MCP）服務器，使AI模型能夠與Windows命令行功能安全且高效地交互。它為AI模型與Windows系統操作搭建了強大且安全的橋樑，支持受控的命令執行、項目創建以及系統信息檢索，並嚴格遵守安全協議。

🚀 快速開始

Windows命令行MCP服務器為AI模型與Windows系統操作提供了強大且安全的連接。下面為你介紹它的安裝和使用方法。

✨ 主要特性

🔒 增強安全性

• 全面的命令允許列表
• 嚴格的輸入驗證
• 防止破壞性系統操作
• 可配置的安全級別

🛠 開發工具支持

• 支持創建React、Node.js和Python項目
• 安全的開發環境交互
• 擴展的命令支持以滿足開發工作流程需求

🖥 系統交互能力

• 執行Windows CLI命令
• 運行PowerShell腳本
• 獲取系統和網絡信息
• 管理進程和服務

📦 安裝指南

通過Smithery安裝

使用Smithery自動安裝Windows命令行MCP服務器以備Claude Desktop：

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

先決條件

• Node.js 16或更高版本
• npm或yarn
• Windows操作系統

設置

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git
cd Windows-Command-Line-MCP-Server
npm install
npm run build

💻 使用示例

命令行選項

• 默認模式：使用預定義的安全命令
• --allow-all：以擴展模式運行（附加註意事項）
• 可自定義命令列表作為參數指定

項目創建

安全地創建新項目，內置項目創建工具支持：

• 支持的項目類型：React、Node.js、Python
• 在受sandbox保護的%USERPROFILE%\Documents\wcl-mcp-server\projects目錄中創建項目

可用工具

1. 系統信息查詢：獲取詳細的系統信息，包括硬件和軟件配置。
2. 網絡信息檢索：列出所有網絡接口的狀態、IP地址和連接信息。
3. 進程管理：查看當前運行的進程並支持終止指定進程。
4. 服務管理：列出所有正在運行的服務及其詳細狀態，並支持停止特定服務。

與Claude for Desktop集成

為了在Claude Desktop中使用該服務器，請將以下內容添加到config.json文件中：

{
    "windowsCommandLineMcp": {
        "enabled": true,
        "port": 3000,
        "path": "%USERPROFILE%/Documents/wcl-mcp-server"
    }
}

📚 詳細文檔

安全考慮

• 允許的操作：執行預定義的命令、創建和管理項目、查詢系統和網絡信息。
• 禁止的操作：直接訪問文件系統、執行任意代碼或進行其他高風險操作。

配置

通過以下命令行選項自定義服務器行為：

# 啟動服務器並指定配置文件
npm run start -- --config ./config.json

# 以調試模式運行
npm run debug

貢獻指南

• 問題：報告錯誤或提出功能請求。
• 代碼貢獻：提交修復或新功能的拉取請求。
• 文檔改進：更新或擴展項目文檔。

版本歷史

• 0.3.0：新增網絡信息檢索功能，改進服務管理模塊。
• 0.2.0：新增項目創建功能，擴展開發工具支持。
• 0.1.0：初始版本，提供基本命令執行能力。

支持

如需幫助、有疑問或建議，請在GitHub問題中提交。

📄 許可證

項目遵循MIT許可證，具體內容請參閱LICENSE文件。