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:

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": [
        "@dillip285/mcp-terminal",
        "--allowed-paths",
        "/path/to/allowed/directory"
      ]
    }
  }
}

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

# Clone the repository
git clone https://github.com/dillip285/mcp-terminal.git

# Install dependencies
npm install

# Configure npm authentication
cp .npmrc.example .npmrc
# Edit .npmrc and add your NPM_TOKEN

# Run tests
npm test

# Build the project
npm run build

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.

Support

For bug reports and feature requests, please open an issue.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

execute_command

A secure server for executing terminal commands within predefined paths, allowing safe interaction by Large Language Models with operating system environments.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
Shell MCP Server
blazickjp
-
security
A
license
-
quality
A 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 -
9
Python
Apache 2.0
MCP Terminal Server
RinardNick
A
security
A
license
A
quality
A secure terminal execution server that enables controlled command execution with security features and resource limits via the Model Context Protocol (MCP).
Last updated -
1
12
1
JavaScript
MIT License
Super Shell MCP Server
cfdude
-
security
A
license
-
quality
An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
Last updated -
13
JavaScript
MIT License

View all related MCP servers

MCP Terminal Server