Windows Command Line MCP Server

by alxspiker

3 stars

355 downloads

Not rated

GitHub

About

This server creates a secure bridge between Claude and your computer's command-line functionality.

Details

Author: alxspiker
Repository: alxspiker/Windows-Command-Line-MCP-Server
GitHub stars: 3
Downloads: 355
License: MIT License
Categories: Developer Tools, AI, Security, Project Management, Infrastructure, Productivity
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Windows Command Line MCP Server

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/dist/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/c",
                "node",
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

From the repository

Customize the server's behavior by specifying allowed commands or using configuration flags.

To install Windows Command Line MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

`execute_command`

Run Windows CLI commands.

`execute_powershell`

Execute PowerShell scripts.

`create_project`

Safely create new development projects.

`list_running_processes`

Retrieve active system processes.

`get_system_info`

Collect system configuration details.

`get_network_info`

Retrieve network adapter information.

`get_scheduled_tasks`

List and query system tasks.

`get_service_info`

Manage and query Windows services.

`list_allowed_commands`

List all commands that can be executed by the server.

1. execute_command: Run Windows CLI commands
2. execute_powershell: Execute PowerShell scripts
3. create_project: Safely create new development projects
4. list_running_processes: Retrieve active system processes
5. get_system_info: Collect system configuration details
6. get_network_info: Retrieve network adapter information
7. get_scheduled_tasks: List and query system tasks
8. get_service_info: Manage and query Windows services
9. list_allowed_commands: List all commands that can be executed by the server

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "windows command line mcp server": {
            "cwd": "",
            "env": {},
            "args": [
                "/path/to/dist/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "",
    "env": [],
    "args": [
        "/path/to/dist/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "",
    "env": [],
    "args": [
        "/path/to/dist/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "",
    "env": [],
    "args": [
        "/c",
        "node",
        "/path/to/dist/index.js"
    ],
    "shell": false,
    "command": "cmd"
}

Windows Command Line MCP Server

A secure Model Context Protocol (MCP) server that enables AI models to interact with Windows command-line functionality safely and efficiently.

Overview

The Windows Command Line MCP Server provides a robust, secure bridge between AI models and Windows system operations. It allows controlled execution of commands, project creation, and system information retrieval while maintaining strict security protocols.

Key Features

🔒 Enhanced Security

- Comprehensive command allowlist - Strict input validation - Prevention of destructive system operations - Configurable security levels

🛠 Development Tools Support

- Project creation for React, Node.js, and Python - Safe development environment interactions - Expanded command support for development workflows

🖥 System Interaction Capabilities

- Execute Windows CLI commands - Run PowerShell scripts - Retrieve system and network information - Manage processes and services

Installation

Installing via Smithery

To install Windows Command Line MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @alxspiker/Windows-Command-Line-MCP-Server --client claude

Prerequisites

- Node.js 16 or later - npm or yarn - Windows operating system

Setup

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git
cd Windows-Command-Line-MCP-Server
npm install
npm run build

Usage

Command Line Options

- Default mode: Uses predefined safe commands - --allow-all: Run in extended mode (with additional precautions) - Custom command lists can be specified as arguments

Project Creation

Create new projects safely with the built-in project creation tool: - Supported project types: React, Node.js, Python - Projects created in a sandboxed ~/AIProjects directory

Available Tools

1. execute_command: Run Windows CLI commands 2. execute_powershell: Execute PowerShell scripts 3. create_project: Safely create new development projects 4. list_running_processes: Retrieve active system processes 5. get_system_info: Collect system configuration details 6. get_network_info: Retrieve network adapter information 7. get_scheduled_tasks: List and query system tasks 8. get_service_info: Manage and query Windows services 9. list_allowed_commands: List all commands that can be executed by the server

Using with Claude for Desktop

To use this server with Claude for Desktop:

1. Build the server using the setup instructions above
2. Add it to your claude_desktop_config.json:

{
  "mcpServers": {
    "windows-cmd": {
      "command": "node",
      "args": ["/path/to/dist/index.js"]
    }
  }
}

Replace /path/to/dist/index.js with the absolute path to the built index.js file in the dist directory.

3. Restart Claude for Desktop
4. You can now use the tools by asking Claude to perform Windows system operations

Security Considerations

Allowed Commands

By default, only safe commands are permitted: - System information retrieval - Network configuration - Process management - Development tool interactions

Blocked Operations

Dangerous commands are always blocked, including: - Disk formatting - User management - System shutdown - Critical registry modifications

Configuration

Customize the server's behavior by specifying allowed commands or using configuration flags.

Example

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

execute_command

execute_powershell

create_project

list_running_processes

get_system_info

get_network_info

get_scheduled_tasks

get_service_info

list_allowed_commands

Claude Desktop / Cursor

Linux

Macos

Windows

Windows Command Line MCP Server

Overview

Key Features

🔒 Enhanced Security

🛠 Development Tools Support

🖥 System Interaction Capabilities

Installation

Installing via Smithery

Prerequisites

Setup

Usage

Command Line Options

Project Creation

Available Tools

Using with Claude for Desktop

Security Considerations

Allowed Commands

Blocked Operations

Configuration

Example

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`execute_command`

`execute_powershell`

`create_project`

`list_running_processes`

`get_system_info`

`get_network_info`

`get_scheduled_tasks`

`get_service_info`

`list_allowed_commands`