Winterm MCP

🚀 WinTerm MCP 服務

WinTerm MCP 服務是一個模型上下文協議服務器，它提供了對 Windows 終端的程序化訪問能力。藉助該服務器，AI 模型能夠通過一組標準化工具與 Windows 命令行接口進行交互，為 Windows 環境下的自動化操作和智能交互提供了便利。

🚀 快速開始

WinTerm MCP 服務專為 Windows 命令行交互設計，可讓 AI 模型與 Windows 終端進行交互。下面為你介紹其使用步驟。

✨ 主要特性

• 寫入終端：可執行命令或向 Windows 終端寫入文本。
• 讀取終端輸出：能獲取之前執行命令的輸出。
• 發送控制字符：可向終端發送控制信號（例如 Ctrl+C）。
• Windows 原生：專門針對 Windows 命令行交互進行設計。

📦 安裝指南

1. 克隆倉庫：

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

2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

4. 配置 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 文件。