Terminal MCP Server

Name: Terminal MCP Server
Author: stat-guy

@stat-guy

リポジトリ

Terminal MCP Server について

MCP server for executing terminal commands through Claude Desktop

基本情報

カテゴリ

開発者ツール

ランタイム

node

トランスポート

stdio

公開者

stat-guy

設定

標準の設定はありません

このサーバーの README には解析可能な MCP 設定ブロックが含まれていません。インストール手順はリポジトリをご確認ください。

リポジトリ

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Terminal MCP Server?

Terminal MCP Server is a Model Context Protocol (MCP) server that enables Claude Desktop to execute terminal commands, navigate directories, and retrieve terminal environment information. It is designed for developers who want to interact with their local terminal directly through Claude.

How to use Terminal MCP Server?

Clone the repository, install dependencies (npm install), and build the project (npm run build). Then add the server configuration to your Claude Desktop configuration file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) with the correct path and the environment variable PERMISSION_REQUIRED: "true". After restarting Claude Desktop, you can ask Claude to run commands such as checking directory contents or changing folders.

Key features of Terminal MCP Server

Execute any terminal command with arguments and options.
Navigate directories while maintaining state between commands.
Get the current working directory path.
Retrieve terminal environment information (shell, user, platform).
Full output capture (stdout, stderr, exit codes).
Proper error handling and formatting.

Use cases of Terminal MCP Server

Quickly list files in a directory without leaving Claude Desktop.
Change to a specific folder and continue executing commands there.
Retrieve terminal environment details during a conversation.
Execute system commands while maintaining session state.

FAQ from Terminal MCP Server

What dependencies are required to run Terminal MCP Server?

Node.js v18 or higher, TypeScript, and Claude Desktop are required.

How is Terminal MCP Server configured for Claude Desktop?

Add a JSON entry to the Claude Desktop configuration file (claude_desktop_config.json) with the command, args pointing to the built dist/index.js, and an environment variable PERMISSION_REQUIRED set to "true".

What security measures does Terminal MCP Server implement?

It requires explicit user permission through Claude Desktop, allows controlling environment variables via configuration, and includes timeouts and error handling for command execution.