MCP Shell Server

MCP Shell Server

site icon
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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。