MCP.so
Sign In

MCP Terminal Server

@RinardNick

Repository

About MCP Terminal Server

An MCP server that provides secure terminal access for Claude and other LLMs

#mcp-terminal#secure-terminal#mcp

Basic information

Category

Developer Tools

License

MIT

Runtime

node

Transports

stdio

Publisher

RinardNick

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-terminal": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Terminal Server?

MCP Terminal Server is a secure terminal execution server implementing the Model Context Protocol (MCP). It provides controlled command execution capabilities with security features and resource limits, designed for use with MCP-based applications like Claude Desktop.

How to use MCP Terminal Server?

Install the package using uv pip install mcp-terminal, then configure Claude Desktop with the command and args fields, specifying allowed commands, timeout, and maximum output size. The server can also be tested with the MCP Inspector tool.

Key features of MCP Terminal Server

  • Execute shell commands with output capture and error handling
  • Restrict allowed commands and prevent command injection
  • Command timeouts and maximum output size limits
  • Standard MCP message format with capability advertisement
  • Streaming output support for long-running commands

Use cases of MCP Terminal Server

  • Running development commands (git, pip, python, ls, cd) through Claude Desktop
  • Executing controlled shell commands from AI agents via MCP
  • Automating terminal tasks with enforced security boundaries and resource protection

FAQ from MCP Terminal Server

What commands are allowed by default?

The server does not allow any commands by default; you must specify the allowed commands using the --allowed-commands argument.

What are the runtime dependencies?

MCP Terminal Server requires Python and the uv package manager. It is designed to work with MCP clients such as Claude Desktop.

How are commands protected from injection?

The server validates commands against a whitelist, blocks shell operators, and prevents command injection attempts.

What resource limits are enforced?

Each command has a configurable timeout (default 30 seconds) and a maximum output size (default 1 MB) to prevent hanging or memory exhaustion.

How does the server communicate?

It implements the Model Context Protocol version 1.0.0, using JSON messages over standard input/output (stdio) with the client.

Comments

More Developer Tools MCP servers

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K

MCP Containers

metorial

Connect any AI model to 1200+ integrations (MCP, CLI, API)

3.3K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K

test

cloudwego

The ultimate LLM/AI application development framework in Go.

12.2K