WinTerm MCP

WinTerm MCP

site icon
2025.02.25 0
JavaScriptWindows 终端交互命令行自动化开发效率
WinTerm MCP 是一个模型上下文协议服务器,提供对 Windows 终端的编程访问。该服务器使 AI 模型能够通过一组标准化工具与 Windows 命令行界面进行交互。
View on GitHub

Overview

基本能力

产品定位

WinTerm MCP 是一个专门为 Windows 命令行交互设计的 MCP 服务器,旨在通过标准化工具集实现 AI 模型与 Windows 终端的程序化交互。

核心功能

  • 写入终端:执行命令或将文本写入 Windows 终端
  • 读取终端输出:从先前执行的命令中检索输出
  • 发送控制字符:向终端发送控制信号(如 Ctrl+C)
  • Windows 原生支持:专为 Windows 命令行交互构建

适用场景

  • AI 模型与 Windows 命令行的自动化交互
  • 开发测试自动化工具
  • 命令行操作的教学演示

工具列表

  1. write_to_terminal:将文本或命令写入终端
  2. read_terminal_output:从终端输出中读取指定行数
  3. send_control_character:向终端发送控制字符(如 Ctrl+C)

常见问题解答

  • 配置时需要确保正确指定构建后的 index.js 文件路径
  • 开发时可以使用 npm run dev 命令实现自动重建

使用教程

使用依赖

  1. 安装 Node.js 环境
  2. 安装 Git(用于克隆仓库)

安装教程

  1. 克隆仓库bash git clone https://github.com/capecoma/winterm-mcp.git cd winterm-mcp

  2. 安装依赖bash npm install

  3. 构建项目bash npm run build

  4. 配置 Claude Desktop

%APPDATA%/Claude/claude_desktop_config.json 中添加服务器配置:

{
  "mcpServers": {
    "github.com/capecoma/winterm-mcp": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

注意:将 "path/to/build/index.js" 替换为实际的 index.js 文件路径。

调试方式

  • 开发模式(自动重建): bash npm run dev
  • 检查终端输出是否正确
  • 验证控制字符是否按预期发送

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。