Windows Command Line MCP Server

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.