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
~/AIProjectsdirectory
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:
{
"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.
- 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
# 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
- 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 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.