The MCP Terminal Server is a secure command-line interface that enables AI models to interact with your terminal while maintaining security and control. With this server, you can:
- Execute Commands: Run terminal commands securely with configurable permissions, including remote execution via SSH
- File System Operations: Perform operations within strictly allowed paths
- Environment Variable Management: Securely manage environment variables for command execution
- Cross-Platform Support: Operate on Windows, macOS, and Linux systems
- Security: Benefit from command validation, restricted paths, and proper error handling
MCP Terminal Server
A secure command-line interface server for the Model Context Protocol (MCP) that enables AI models to interact with your terminal while maintaining security and control.
Features
- 🔒 Secure command execution with configurable permissions
- 📁 File system operations within allowed paths
- 🌍 Environment variable management
- 💻 Cross-platform support (Windows, macOS, Linux)
- 🔌 Remote system connections support via command execution
Usage with Claude Desktop
Add the server configuration to your Claude Desktop config file:
Restart Claude Desktop to apply the changes. You can now use the terminal capabilities through Claude with secure file access and command execution.
Available Tools
execute_command
: Run terminal commands securely (including SSH and remote commands)
Security
- All operations are restricted to specified allowed paths
- Commands are validated and sanitized before execution
- Environment variables are carefully managed
- Proper error handling for security-related issues
Development
Publishing
To publish the package:
- Copy
.npmrc.example
to.npmrc
- Add your npm authentication token to
.npmrc
- Run
npm publish --access public
Note: Never commit your .npmrc
file with the authentication token. It is already added to .gitignore
.
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'feat: Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
License
MIT License - see the LICENSE file for details.
Related Projects
Support
For bug reports and feature requests, please open an issue.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A secure server for executing terminal commands within predefined paths, allowing safe interaction by Large Language Models with operating system environments.
- Features
- Usage with Claude Desktop
- Available Tools
- Security
- Development
- Publishing
- Contributing
- License
- Related Projects
- Support
Related Resources
Related MCP Servers
- -securityFlicense-qualityA secure server that allows LLM applications like Claude to execute whitelisted system commands with user confirmation and comprehensive security features.Last updated -Python
- -securityAlicense-qualityA secure server that enables AI applications to execute shell commands in specified directories, supporting multiple shell types (bash, sh, cmd, powershell) with built-in security features like directory isolation and timeout control.Last updated -10PythonApache 2.0
- AsecurityAlicenseAqualityA secure terminal execution server that enables controlled command execution with security features and resource limits via the Model Context Protocol (MCP).Last updated -14186JavaScriptMIT License
- -securityFlicense-qualityA secure interface that enables language models to execute shell commands on the host operating system through the Model Context Protocol.Last updated -1Python