金大哥 - winterm-mcp MCP 详情

article

README

🚀 WinTerm MCP 服务

WinTerm MCP 服务是一个模型上下文协议服务器，它提供了对 Windows 终端的程序化访问能力。借助该服务器，AI 模型能够通过一组标准化工具与 Windows 命令行接口进行交互，为 Windows 环境下的自动化操作和智能交互提供了便利。

🚀 快速开始

WinTerm MCP 服务专为 Windows 命令行交互设计，可让 AI 模型与 Windows 终端进行交互。下面为你介绍其使用步骤。

✨ 主要特性

写入终端：可执行命令或向 Windows 终端写入文本。
读取终端输出：能获取之前执行命令的输出。
发送控制字符：可向终端发送控制信号（例如 Ctrl+C）。
Windows 原生：专门针对 Windows 命令行交互进行设计。

📦 安装指南

克隆仓库：

git clone https://github.com/capecoma/winterm-mcp.git
cd winterm-mcp

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```
配置 Claude 桌面：将服务器配置添加到 %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 文件路径。

💻 使用示例

基础用法

`write_to_terminal`

向终端写入文本或命令。

{
  "command": "echo Hello, World!"
}

`read_terminal_output`

从终端输出中读取指定数量的行。

{
  "linesOfOutput": 5
}

`send_control_character`

向终端发送控制字符（例如 Ctrl+C）。

{
  "letter": "C"
}

🔧 技术细节

带有自动重建功能的开发：

npm run dev

📄 许可证

本项目采用 MIT License 许可协议，详情请参阅 LICENSE 文件。

winterm-mcp