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

# Run with default safe commands
node dist/index.js

# Run with specific allowed commands
node dist/index.js dir echo npm git

# Run in extended mode (use with caution)
node dist/index.js --allow-all

Contributing

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add some amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• Inspired by the Model Context Protocol specification
• Developed with security and flexibility in mind

Version History

• 0.3.0: Implemented all tools mentioned in README (system info, network info, process management, service info)
• 0.2.0: Added project creation, expanded development tools
• 0.1.0: Initial release with basic command execution capabilities

Support

For issues, questions, or suggestions, please open an issue on GitHub.