WinTerm MCP

Provides programmatic access to the Windows terminal, enabling AI models to interact with the command line interface.

GitHub

WinTerm MCP

A Model Context Protocol server that provides programmatic access to the Windows terminal. This server enables AI models to interact with the Windows command line interface through a set of standardized tools.

Features

  • Write to Terminal: Execute commands or write text to the Windows terminal
  • Read Terminal Output: Retrieve output from previously executed commands
  • Send Control Characters: Send control signals (e.g., Ctrl+C) to the terminal
  • Windows-Native: Built specifically for Windows command line interaction

Installation

  1. Clone the Repository:

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

  2. Install Dependencies:

    npm install

  3. Build the Project:

    npm run build

  4. Configure Claude Desktop:

Add the server config to %APPDATA%/Claude/claude_desktop_config.json:

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

Note: Replace "path/to/build/index.js" with the actual path to your built index.js file.

Available Tools

write_to_terminal

Writes text or commands to the terminal.

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

read_terminal_output

Reads the specified number of lines from terminal output.

{
  "linesOfOutput": 5
}

send_control_character

Sends a control character to the terminal (e.g., Ctrl+C).

{
  "letter": "C"
}

Development

For development with auto-rebuild:

npm run dev

License

MIT License - see LICENSE file.

Servidores relacionados