shell-command-mcp

shell-command-mcp

site icon
2025.04.07 20
TypeScriptshell 命令执行开发工具开发效率
shell-command-mcp 是一个用于执行 shell 命令的 MCP 服务器。它允许用户通过配置或环境变量来指定允许执行的命令,从而提供灵活且安全的 shell 命令执行能力。
View on GitHub

Overview

基本能力

产品定位

shell-command-mcp 是一个用于执行 shell 命令的 MCP 服务器,旨在提供灵活且安全的 shell 命令执行能力。

核心功能

  1. 执行 shell 命令:支持通过 MCP 服务器执行指定的 shell 命令。
  2. 命令限制:通过环境变量 ALLOWED_COMMANDS 可以限制允许执行的命令,增强安全性。
  3. 灵活配置:支持通过 JSON 配置文件或命令行参数进行配置。

适用场景

  1. 开发环境:在开发过程中快速执行常见的 shell 命令。
  2. 自动化脚本:集成到自动化脚本中,执行特定的 shell 命令。
  3. 安全执行:通过限制允许的命令,确保只有安全的命令可以被执行。

工具列表

  1. npx:用于启动 shell-command-mcp 服务器。
  2. ALLOWED_COMMANDS:环境变量,用于指定允许执行的命令列表。

常见问题解答

  1. 如何限制允许执行的命令? 通过设置 ALLOWED_COMMANDS 环境变量,可以指定允许执行的命令列表,例如 ALLOWED_COMMANDS="cat,ls,echo"
  2. 如何启动服务器? 可以使用 npx -y shell-command-mcp 命令启动服务器。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm。
  2. 确保已安装 npx(通常随 npm 一起安装)。

安装教程

  1. 通过 npx 直接运行: bash npx -y shell-command-mcp
  2. 通过 JSON 配置文件运行: json { "mcpServers": { "shell-command": { "command": "npx", "args": ["-y", "shell-command-mcp"], "env": { "ALLOWED_COMMANDS": "cat,ls,echo" } } } }

调试方式

  1. 启动服务器后,可以通过执行允许的命令来测试功能,例如: bash echo "Hello, World!"
  2. 检查服务器日志以确保命令被正确执行。

许可证

该项目遵循 MIT 开源许可条款。