@setkyar/terminal-mcp v1.0.0

Terminal MCP Server

A Model Context Protocol (MCP) server that provides secure terminal command execution capabilities.

Installation

bun install

Usage

Run the server with one or more allowed directories:

bun run src/index.ts /absolute/path/to/allowed/directory

Multiple directories can be specified with comma separation:

bun run src/index.ts "/path1,/path2,/path3"

Security

• Commands are restricted to specified allowed directories
• Dangerous commands are blocked (sudo, rm -rf outside allowed dirs, etc.)
• All paths must be absolute for security

Available Tools

• execute_command: Execute shell commands in the allowed directories