win-cli-mcp-tmyy

Windows 命令行 MCP 服务器 — 为 AI 客户端（如 Trae、Claude Desktop 等）提供 Windows 系统的命令行执行、文件系统操作、系统信息查询、代码检查等功能，通过 MCP（Model Context Protocol）协议进行通信。

功能特性

命令执行

• cmd_exec — 执行 Windows CMD 命令，支持环境变量传递、输出截断、路径自动转义

• powershell_exec — 执行 PowerShell 命令，脚本自动写入系统临时目录执行，避免内联转义问题

文件系统操作

• read_file — 读取文件内容，支持指定编码和行范围（单次上限 5MB）

• write_file — 直接写入文件，支持 content / content_base64、unicode_escape、lineEnding 参数，原子写

• edit_file — 按行范围替换文件内容，支持 preserve_indent 自动缩进适配

• list_directory — 列出目录内容，支持递归和深度限制

• find_files — 基于 minimatch 模式匹配的文件搜索（原生 Node.js 实现），自动忽略 node_modules/.git

• search_text — 目录树文件内容搜索，支持子串/正则、文件名过滤、忽略目录

• get_file_info — 获取文件/目录的详细元数据（大小、时间、类型、权限）

• create_directory — 递归创建目录

• delete_path — 删除文件或目录，支持移入回收站（可恢复）

• move_path — 移动或重命名文件/目录，支持跨驱动器（自动回退到复制+删除）

• delete_lines / insert_lines — 按行删除/插入文件内容

• zip_create / zip_extract — zip 压缩与解压

• file_hash — 文件哈希校验（SHA256/MD5/SHA1）

• disk_usage — 目录磁盘占用分析（总大小 + 子目录排行）

进程与服务管理

• list_processes — 列出运行中的进程（按 CPU 降序）

• kill_process — 按 PID 或名称终止进程

• list_services — 列出 Windows 服务及状态

• start_service / stop_service — 启停 Windows 服务

系统与网络信息

• list_drives — 列出所有可用驱动器及使用情况

• get_env — 获取环境变量

• get_system_info — 获取 OS 版本、CPU、内存、主机名等系统信息（基于 CIM）

• get_network_info — 获取网络接口、IP、网关、DNS 信息

• list_ports — 列出占用中的 TCP 端口及所属进程

代码检查

• check_npm — npm 项目错误检查（npm install / npm run build）

• check_python — Python 文件语法检查（py_compile）

• check_go — Go 项目编译检查（go build）

• check_rust — Rust 项目错误检查（cargo check）

• check_java — Java 文件/项目编译检查（javac）

• check_csharp — C#/.NET 项目构建检查（dotnet build）

• check_bash — Bash 脚本语法检查（bash -n）

• check_sql — SQL 脚本语法检查（内存 SQLite，无副作用）

Git 工具

• git_status — 查看仓库工作区状态

• git_diff — 查看未提交改动

• git_log — 查看提交历史

高级工具

• bom_manage — 检测、添加、移除文件 BOM（Byte Order Mark），支持 UTF-8/UTF-16/UTF-32

• base64_manage — Base64 编解码，支持文本和文件，辅助 edit_file 避免 JSON 转义问题

• deep_thinking — 结构化深度思考工具，模拟 Sequential Thinking 模式，支持逐步推理、修订、多分支探索

• mcp_proxy — MCP 穿透工具，调用其他 MCP 服务器的工具，支持任意 stdio 模式的 MCP 服务器

• get_project_doc — 获取本项目完整说明书（project.md）

MCP 协议能力

• Resources — 暴露 mcp://info、项目文档及任意 file:// 路径资源

• Prompts — 预设 code_review / diagnose / project_scan 任务模板

• 工具禁用配置 — 通过环境变量 WIN_CLI_MCP_DISABLED_TOOLS 隐藏并拒绝指定工具

可靠性与智能处理

• 并发信号量 — 同时执行的命令数上限 4，防止资源耗尽

• 原子写 — 文件写入采用临时文件+rename，防止写坏文件

• 输出截断 — 命令输出超过 20000 字符自动截断，防止超出 AI 上下文窗口

• 自动 Unicode 转义 — 默认将 \uXXXX 字面字符串转换为实际 Unicode 字符（如 \u00a7 → §），可用 unicode_escape: false 关闭

• 换行符控制 — 默认归一化 CRLF/CR 为 LF，可用 lineEnding: 'crlf'/'auto' 控制

• BOM 自动处理 — 读取文件时自动剥离 BOM，避免解析异常

• 跨驱动器移动 — 检测 EXDEV 错误，自动回退到复制+删除方案

Related MCP server: AETHER_01

技术栈

• 运行时: Node.js（ES Modules）

• 核心依赖:

  • @modelcontextprotocol/sdk — MCP 协议官方 SDK

  • minimatch — 文件搜索模式匹配

• 协议: MCP（Model Context Protocol）via stdio JSON-RPC 2.0

项目结构

win-cli-mcp-tmyy/
├── index.js          # 主入口文件，包含所有工具实现和 MCP 服务器逻辑
├── package.json      # 项目配置、依赖管理
├── install.bat       # 本地安装脚本（npm link）
├── .gitignore        # Git 忽略规则
├── LICENSE           # 协议文件
├── README.md         # 本说明文件
└── project.md        # 详细项目说明书（供 AI 读取）

安装

npm install -g win-cli-mcp-tmyy

配置

在 AI 客户端（如 Trae）的 MCP 配置中添加：

{
  "mcpServers": {
    "win-cli-mcp-tmyy": {
      "command": "npx",
      "args": ["win-cli-mcp-tmyy"]
    }
  }
}

可选：通过 env 禁用部分工具（逗号分隔工具名）。被禁用的工具不会出现在工具列表中，调用也会被拒绝：

{
  "mcpServers": {
    "win-cli-mcp-tmyy": {
      "command": "npx",
      "args": ["win-cli-mcp-tmyy"],
      "env": {
        "WIN_CLI_MCP_DISABLED_TOOLS": "mcp_proxy,kill_process"
      }
    }
  }
}

协议

Business Source License 1.1

• ✅ 开源可查看 — 任何人都可以查看、复制、修改、非商业使用

• ⚠️ 商业需授权 — 商业使用（包括但不限于销售、嵌入商业产品、作为商业服务提供）需联系作者获取商业许可

• 🔄 到期自动转 Apache 2.0 — 2030-08-05 后协议自动转为 Apache License 2.0，届时完全开源

本协议由 MariaDB 创建，被 CockroachDB、Sentry 等知名项目采用，是广泛认可的"源代码可用、商业需授权"协议方案。