MCP Shell Server
@MCP-Mirror
关于 MCP Shell Server
Mirror of
基本信息
配置
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"mkusaka_mcp-shell-server": {
"command": "node",
"args": [
"dist/index.js"
]
}
}
}工具
未检测到工具
工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。
概览
What is MCP Shell Server?
MCP Shell Server is a bridge that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands. It supports single-line and multi-line commands across multiple shells and is designed for integration with AI assistants like Cursor.
How to use MCP Shell Server?
Install globally via npm, yarn, or pnpm, then add the server to your MCP configuration (e.g., in Cursor's ~/.cursor/config.json). The server provides a shell_exec tool that accepts a required command string. You can also specify a custom shell using the -s or --shell command-line argument.
Key features of MCP Shell Server
- Execute shell commands (single-line and multi-line support)
- Support for various shells (bash, zsh, fish, powershell, cmd, etc.)
- Detailed error handling and logging
- MCP Inspector compatible
- Provides system information as resources (hostname, platform, shell, username, system-info)
Use cases of MCP Shell Server
- AI assistants executing shell commands to solve coding tasks
- Retrieving system information (hostname, platform, memory, uptime) during agent interactions
- Running multi-line scripts (e.g., heredoc) via AI tools
- Debugging and system administration through natural language interfaces
FAQ from MCP Shell Server
What shells does MCP Shell Server support?
It supports bash, zsh, fish, powershell, cmd, and others. You can specify a custom shell path with the -s or --shell argument when starting the server.
What is the required parameter for the shell_exec tool?
The command parameter is required and must be a string containing the shell command to execute.
How do I install MCP Shell Server?
Install it globally: npm install -g @mkusaka/mcp-shell-server, yarn global add @mkusaka/mcp-shell-server, or pnpm add -g @mkusaka/mcp-shell-server.
What system resources does MCP Shell Server expose?
It exposes hostname://, platform://, shell://, username://, and system-info:// (which returns hostname, platform, shell, username, CPU count, total/free memory, and uptime).
Does MCP Shell Server support Windows shells?
Yes, it supports both powershell and cmd in addition to Unix shells like bash and zsh.
开发工具 分类下的更多 MCP 服务器
Smithery CLI
smithery-aiInstall, manage and develop MCP servers and skills for agents
test
cloudwegoThe ultimate LLM/AI application development framework in Go.
MCP-Scan: An MCP Security Scanner
invariantlabs-aiSecurity scanner for AI agents, MCP servers and agent skills.
Grafana MCP server
grafanaMCP server for Grafana
mcp-excalidraw
yctimlinMCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.
评论