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

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K

MCP Unity Editor (Game Engine)

CoderGamester

Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs

1.8K

Hello World MCP Server (Reference Extension)

anthropics

Desktop Extensions: One-click local MCP server installation in desktop apps

2.0K

sentry-mcp

getsentry

An MCP server for interacting with Sentry via LLMs.

754

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K