Terminal server implementation for Model Context Protocol
{
"mcpServers": {
"mcp-terminal-server": {
"args": [
"-y",
"@modelcontextprotocol/server-terminal"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Terminal server implementation for Model Context Protocol
Is it safe?
No known CVEs for @modelcontextprotocol/server-terminal.
No authentication — any process on your machine can connect.
License not specified.
Is it maintained?
Last commit 492 days ago. 5 stars.
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@modelcontextprotocol/server-terminal' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
No known vulnerabilities.
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationHave you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Dynamic problem-solving through sequential thought chains
A Model Context Protocol server for searching and analyzing arXiv papers
An open-source AI agent that brings the power of Gemini directly into your terminal.
MCP Security Weekly
Get CVE alerts and security updates for Mcp Terminal Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
# @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
```