win-cli-mcp-tmyy

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

功能特性

命令执行

• cmd_exec — 执行 Windows CMD 命令，支持环境变量传递

• powershell_exec — 执行 PowerShell 命令，长脚本自动写入临时文件执行，避免内联转义问题

文件系统操作

• read_file — 读取文件内容，支持指定编码和行范围

• write_file — 直接写入文件，支持 content 和 content_base64 两种方式

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

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

• find_files — 基于 minimatch 模式匹配的文件搜索（原生 Node.js 实现，不依赖 PowerShell）

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

• create_directory — 递归创建目录

• delete_path — 删除文件或目录（非空目录需指定 recursive: true）

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

系统信息

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

• get_env — 获取环境变量

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

代码检查

• 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）

高级工具

• 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 服务器

智能处理

• 自动 Unicode 转义 — 自动将 \uXXXX 字面字符串转换为实际 Unicode 字符（如 \u00a7 → §），解决 JSON 多层转义导致的中文乱码问题

• 换行符归一化 — 自动将 CRLF/CR 统一为 LF

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

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

Related MCP server: OmniFlow

技术栈

• 运行时: 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 + npm install）
├── .gitignore        # Git 忽略规则
├── LICENSE           # 协议文件
├── README.md         # 本说明文件
└── project.md        # 详细项目说明书（供 AI 读取）

安装

# 方式一：运行安装脚本
install.bat

# 方式二：手动安装
npm install
npm link

配置

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

{
  "mcpServers": {
    "win-cli-mcp-tmyy": {
      "command": "node",
      "args": ["D:\\AI\\MCP\\win-cli-mcp-tmyy\\index.js"]
    }
  }
}

协议

Business Source License 1.1

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

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

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

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