trackmcp
Back to directory
RichardTheuws

mcp-terminal-server

View on GitHub

Terminal server implementation for Model Context Protocol

4 stars TypeScriptAI & Machine Learning Updated Jun 22, 2025

Documentation

@modelcontextprotocol/server-terminal

Terminal server implementation for Model Context Protocol (MCP). Provides secure and controlled access to terminal commands and npm operations.

Features

  • Execute shell commands with full control
  • Built-in npm operations (install, run scripts)
  • Timeout handling
  • Security through allowed commands list
  • Environment variables management
  • Working directory control
  • Typescript support

Installation

bash
npm install @modelcontextprotocol/server-terminal

Configuration

Add to your MCP config:

json
{
  "terminal": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-terminal"],
    "autoApproveScope": ["execute_command", "npm_install", "npm_run"],
    "config": {
      "allowedCommands": ["npm", "node", "git"],
      "defaultTimeout": 30000,
      "defaultCwd": "/your/project/path",
      "environmentVariables": {
        "NODE_ENV": "development"
      }
    }
  }
}

Usage

typescript
// Execute command
const result = await terminal.executeCommand('ls', ['-la'], {
  cwd: '/some/path'
});

// Install npm package
await terminal.install('typescript');

// Run npm script
await terminal.runScript('build');

// Direct npm commands
await terminal.dev();  // npm run dev
await terminal.build();  // npm run build

Frequently asked questions

What is mcp-terminal-server?

mcp-terminal-server is Terminal server implementation for Model Context Protocol

How do I install mcp-terminal-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-terminal-server open source?

Yes — it is hosted on GitHub at https://github.com/RichardTheuws/mcp-terminal-server and has 4 stars.

Related MCP tools

CherryHQcherry-studio

🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Built for the Model Context Protocol to enhance AI capabilities.

35,025 TypeScript
agentanthropicassistant+6
danny-avilalibrechat

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini...

31,284 TypeScript
aianthropicartifacts+17
labringfastgpt

FastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, ...

26,183 TypeScript
agentclaudedeepseek+7
ComposioHQcomposio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf

25,863 TypeScript
agentic-aiagentsai+14
yamadashyrepomix

📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...

19,761 TypeScript
aianthropicartificial-intelligence+17
activepiecesactivepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...

18,776 TypeScript
ai-agentai-agent-toolsai-agents+10

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP