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.
[](https://smithery.ai/server/@alxspiker/Windows-Command-Line-MCP-Server)
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](https://smithery.ai/server/@alxspiker/Windows-Command-Line-MCP-Server):
Prerequisites
- Node.js 16 or later
- npm or yarn
- Windows operating system
Setup
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
- **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
Using with Claude for Desktop
To use this server with Claude for Desktop:
- Build the server using the setup instructions above
- Add it to your `claude_desktop_config.json`:
Replace `/path/to/dist/index.js` with the absolute path to the built `index.js` file in the `dist` directory.
- Restart Claude for Desktop
- 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
Contributing
- Fork the repository
- Create your feature branch (`git checkout -b feature/amazing-feature`)
- Commit your changes (`git commit -m 'Add some amazing feature'`)
- Push to the branch (`git push origin feature/amazing-feature`)
- Open a Pull Request
License
This project is licensed under the MIT License - see the [LICENSE](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](https://github.com/alxspiker/Windows-Command-Line-MCP-Server/issues) on GitHub.