WinTerm MCP

by capecoma

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

A Model Context Protocol server that provides programmatic access to the Windows terminal, enabling AI models to interact with the Windows command line through standardized tools for writing commands, reading output, and sending control signals.

  1. Features
    1. Installation
      1. Available Tools
        1. write_to_terminal
        2. read_terminal_output
        3. send_control_character
      2. Development
        1. License

          Related MCP Servers

          • A
            security
            F
            license
            A
            quality
            A Model Context Protocol server that allows secure execution of pre-approved commands, enabling AI assistants to safely interact with the user's system.
            Last updated -
            1
            3
            18
            JavaScript
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
            Last updated -
            1
            Python
            • Linux
            • Apple
          • A
            security
            A
            license
            A
            quality
            A server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).
            Last updated -
            3
            3
            Python
            MIT License
            • Apple
            • Linux
          • A
            security
            A
            license
            A
            quality
            A secure Model Context Protocol server that allows AI models to safely interact with Windows command-line functionality, enabling controlled execution of system commands, project creation, and system information retrieval.
            Last updated -
            8
            3
            TypeScript
            MIT License

          View all related MCP servers

          ID: fzjwms9o1t