
MCP Shell Server

2025.04.04
0
TypeScriptshell 命令执行AI 代理工具开发效率
MCP Shell Server 是一个基于模型上下文协议(MCP)的服务,用于安全地执行 shell 命令。它充当 AI 代理与 shell 命令执行之间的桥梁,支持多种 shell 环境,并提供详细的错误处理和日志记录功能。
View on GitHub
Overview
基本能力
产品定位
MCP Shell Server 是一个用于安全执行 shell 命令的服务,特别适用于 AI 代理或自动化工具需要与系统 shell 交互的场景。
核心功能
- 执行 shell 命令(支持单行和多行命令)
- 支持多种 shell 环境(bash、zsh、fish、powershell、cmd 等)
- 详细的错误处理和日志记录
- 兼容 MCP Inspector
适用场景
- AI 代理需要执行系统命令
- 自动化工具需要与 shell 交互
- 开发环境中的命令执行测试
工具列表
shell_exec
: 执行指定的 shell 命令- 参数:
command
(string, 必需): 要执行的 shell 命令
常见问题解答
- 无特定常见问题在 README 中提及
使用教程
使用依赖
- Node.js 环境
安装教程
从 npm 安装(用户)
# 使用 npm
npm install -g @mkusaka/mcp-shell-server
# 使用 yarn
yarn global add @mkusaka/mcp-shell-server
# 使用 pnpm
pnpm add -g @mkusaka/mcp-shell-server
从源码安装(开发)
# 克隆仓库
git clone https://github.com/mkusaka/mcp-shell-server.git
cd mcp-shell-server
# 安装依赖
pnpm install
# 构建项目
pnpm build
调试方式
直接执行
node dist/index.js
# 或作为可执行文件
./dist/index.js
开发模式
pnpm dev
使用 MCP Inspector 测试
pnpm inspect