Skip to main content
Glama
enesjakozh

Bash MCP

by yannbam
GitHub
TypeScript
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Bash MCP (Master Control Program)

A TypeScript application that allows Claude to safely execute bash commands with security safeguards. This project implements the Model Context Protocol (MCP) to provide a secure interface for executing bash commands from AI assistants like Claude.

Features

  • Execute bash commands in a controlled environment

  • Support for both stateless and stateful (interactive) command execution

  • Security safeguards:

    • Whitelisted commands

    • Whitelisted directories

    • Command validation

    • Output sanitization

  • Session management for interactive commands

  • Comprehensive logging

  • MCP server implementation for AI integration

Installation

npm install npm run build

Configuration

The configuration is stored in config/default.json. You can customize:

  • Allowed commands

  • Allowed directories

  • Session settings

  • Security settings

  • Logging settings

Example configuration:

{ "allowedCommands": ["ls", "cat", "echo", "pwd"], "allowedDirectories": ["/tmp", "/home"], "session": { "timeout": 300, "maxActiveSessions": 5, "defaultMode": "stateless" }, "security": { "validateCommandsStrictly": true, "sanitizeOutput": true, "maxOutputSize": 1048576, "commandTimeout": 30 }, "logging": { "level": "info", "file": "logs/bash-mcp.log", "maxSize": 10485760, "maxFiles": 5 } }

Usage

As a Library

Simple Command Execution

import { executeCommand } from 'bash-mcp'; const result = await executeCommand('ls -la', { cwd: '/home/user' }); console.log(result.output);

Interactive Sessions

import { initBashMCP } from 'bash-mcp'; const mcp = await initBashMCP(); // Create a session const session = mcp.createSession('/home/user'); const sessionId = session.sessionId; // Execute a command in the session const result1 = await mcp.executeCommand('ls -la', { sessionId }); console.log(result1.output); // Send input to the session const result2 = await mcp.sendInput({ sessionId, input: 'echo "Hello, world!"' }); console.log(result2.output); // Close the session when done mcp.closeSession(sessionId);

As an MCP Server

This project includes an MCP server implementation that can be used with Claude Desktop or other MCP clients:

# Start the TypeScript MCP server npm run mcp # Start the JavaScript MCP server npm run mcp-js # Start with MCP Inspector npm run inspector

See MCP.md for detailed documentation on the MCP server implementation.

Security Considerations

This MCP is designed with security in mind, but it's important to:

  • Keep the allowed commands and directories list as restrictive as possible

  • Regularly review and update the configuration

  • Monitor the logs for suspicious activity

  • Keep the MCP and its dependencies up to date

Development

Building

npm run build

Linting and Formatting

To check for linting issues:

npm run lint

To automatically fix linting and formatting issues:

./fix-lint.sh

Or manually:

npm run lint:fix # Fix linting issues npm run format # Format code

Testing

npm test

MCP SDK Version

This project uses MCP SDK version 1.0.1.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

A TypeScript application that allows Claude to safely execute bash commands with security safeguards, providing a secure interface through the Model Context Protocol.

  1. Features
    1. Installation
      1. Configuration
        1. Usage
          1. As a Library
          2. As an MCP Server
        2. Security Considerations
          1. Development
            1. Building
            2. Linting and Formatting
            3. Testing
          2. MCP SDK Version

            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
              131
              MIT License
              • Apple

            • Windows CLI MCP Server

              simon-ami
              A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that provides secure command-line access to Windows systems, allowing MCP clients like Claude Desktop to safely execute commands in PowerShell, CMD, and Git Bash shells with configurable security controls.
              Last updated -
              9
              256
              248
              MIT License

            • Shell MCP Server

              hdresearch
              A
              security
              A
              license
              A
              quality
              A Node.js implementation of the Model Context Protocol that provides secure shell command execution capabilities, allowing AI models like Claude to run shell commands in a controlled environment with built-in security measures.
              Last updated -
              1
              117
              37
              MIT License
              • Apple

            • Bash MCP (Master Control Program)

              yannbam
              -
              security
              F
              license
              -
              quality
              A TypeScript application that allows Claude to safely execute bash commands with security safeguards including whitelisted commands, directories, and comprehensive logging.
              Last updated -
              • Linux

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/yannbam/fresh-bash-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server