mcpField
T
Terminal MCP Server

Terminal MCP Server

Local
github.com/algae514Developer Tools1Updated 83w ago
Repository

About Terminal MCP Server

Terminal MCP Server is an MCP server implementation that lets Claude execute terminal commands in configured directories. Its README emphasizes directory access controls and caution when granting command execution permissions.

Key features

  1. 01Execute terminal commands through Claude
  2. 02Limit access to configured directories
  3. 03Configure as a Claude MCP server

Use cases

  1. 01Run terminal commands from Claude
  2. 02Restrict command access to selected directories

MCP support

Exposes terminal command execution to MCP clients such as Claude. Access is scoped to configured directories.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Terminal MCP Server

This repository contains a Model Context Protocol (MCP) server implementation for terminal commands.

Setup Instructions

Prerequisites
  • Node.js (v16 or higher)
  • npm (v7 or higher)
Local Setup
  1. Clone the repository:
git clone https://github.com/algae514/terminal-mcp-server.git
cd terminal-mcp-server
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. Make the start script executable:
chmod +x start-server.sh
Configuration

To use this server with Claude, you need to update your Claude configuration to include the terminal MCP server.

Update your Claude configuration file (typically located at ~/.config/claude/claude_desktop_config.json or similar) to include the following:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/directory1",
        "/path/to/directory2",
        "/path/to/directory3"
      ]
    },
    "terminal": {
      "command": "/path/to/terminal-mcp-server/start-server.sh",
      "args": []
    }
  }
}

Replace /path/to/directory1, /path/to/directory2, etc. with the directories you want to make accessible to Claude.

Replace /path/to/terminal-mcp-server with the actual path where you cloned this repository.

Usage

Once configured, Claude can execute terminal commands in the specified directories through the terminal MCP server.

Security Considerations

  • To allow terminal to run a command in a directory you need to provide it locations in maven-tool.json file. a sample url is provided.
  • Be cautious about the directories you expose to Claude, as it will have access to execute commands in these locations.
  • Consider using a dedicated user with limited permissions for running the server.
  • Review the commands executed by Claude to ensure they are safe and appropriate.

License

MIT License

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.