WinTerm MCP：Windows 终端 Model Context Protocol 服务器

项目简介

WinTerm MCP 是一个 Model Context Protocol (MCP) 服务器，它允许 AI 模型通过预定义的工具与 Windows 命令行终端进行交互。通过此服务器，AI 模型可以执行命令、读取终端输出，以及发送控制字符，从而实现与 Windows 系统的程序化交互。

主要功能点

写入终端 (Write to Terminal): 允许 AI 模型向 Windows 终端发送文本或命令，并执行这些命令。
读取终端输出 (Read Terminal Output): 允许 AI 模型获取之前执行命令在终端产生的输出结果。
发送控制字符 (Send Control Characters): 允许 AI 模型向终端发送控制信号，例如 'Ctrl+C'，用于中断正在运行的进程。
Windows 原生 (Windows-Native): 专为 Windows 命令行环境构建，提供与 Windows 系统深度集成的工具。

安装步骤

克隆仓库: 打开命令提示符或 PowerShell，执行以下命令克隆仓库到本地：

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

安装依赖: 在项目根目录下，执行以下命令安装项目依赖：
```
npm install
```
构建项目: 执行以下命令构建项目：
```
npm run build
```
构建成功后，会在项目目录下生成 'build' 文件夹，服务器程序 'index.js' 位于 'build' 文件夹内。

服务器配置

要将 WinTerm MCP 服务器配置为 MCP 客户端（例如 Claude Desktop）的后端服务，您需要在 MCP 客户端的配置文件中添加服务器配置信息。

对于 Claude Desktop，您需要编辑 '%APPDATA%/Claude/claude_desktop_config.json' 文件，并在 'mcpServers' 字段下添加如下配置：

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

'github.com/capecoma/winterm-mcp': 服务器名称，用于在客户端中标识该服务器。您可以自定义此名称。
'command': 启动服务器的命令，这里使用 'node' 解释器。
'args': 启动服务器命令的参数，指向构建后的服务器程序入口文件 'path/to/build/index.js'。 请将 'path/to/build/index.js' 替换为 'build/index.js' 的实际绝对路径。 例如，如果您的项目根目录在 'C:\winterm-mcp'，则应替换为 'C:\winterm-mcp\build\index.js'。
'disabled': 设置为 'false' 表示启用该服务器。
'autoApprove': 一个工具名称数组，用于自动批准对这些工具的调用，这里设置为空数组表示不自动批准任何工具，每次调用工具都需要手动批准（如果客户端支持）。

基本使用方法

配置完成后，MCP 客户端（如 Claude Desktop）应该能够检测到 WinTerm MCP 服务器。您可以通过客户端提供的界面或方式调用服务器提供的工具，与 Windows 终端进行交互。

以下是服务器提供的工具及其使用示例：

'write_to_terminal': 向终端写入文本或命令。

请求示例 (JSON):

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

'read_terminal_output': 读取终端输出。

请求示例 (JSON):

{
  "linesOfOutput": 10
}

'send_control_character': 发送控制字符。

请求示例 (JSON):
```
{
  "letter": "C"
}
```

请参考您的 MCP 客户端的文档，了解如何配置和使用 MCP 服务器，以及如何调用这些工具。

关键词

WinTerm MCP：Windows 终端 Model Context Protocol 服务器

信息