Windows Command Line MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
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:
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 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.
You must be authenticated.
A secure Model Context Protocol server that allows AI models to safely interact with Windows command-line functionality, enabling controlled execution of system commands, project creation, and system information retrieval.
- Overview
- Key Features
- Installation
- Usage
- Using with Claude for Desktop
- Security Considerations
- Configuration
- Contributing
- License
- Acknowledgements
- Version History
- Support