mcpField
S
shell-command-mcp

shell-command-mcp

本地服务
github.com/egoist开发工具6681 周前更新
代码仓库

关于 shell-command-mcp

shell-command-mcp 是一个用于执行 Shell 命令的 MCP 服务，通过 npx 运行。用户可以通过环境变量限定允许执行的命令，适合需要让 Agent 在本地运行命令的场景。

主要功能

  1. 01通过 npx 启动的 stdio 服务
  2. 02ALLOWED_COMMANDS 环境变量控制可执行命令
  3. 03支持使用 * 允许任意命令

适用场景

  1. 01让 Claude 在本地执行受限的 Shell 命令
  2. 02配置只读命令白名单（如 cat、ls、echo）

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露执行 Shell 命令的能力，并可通过环境变量限制可用命令。

#shell-command#mcp#command-execution

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "shell-command": {
      "command": "npx",
      "args": [
        "-y",
        "shell-command-mcp"
      ]
    }
  }
}
启动命令npx -y shell-command-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmshell-command-mcp

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
commandstring是要执行的 shell 命令。

详细介绍

shell-command-mcp

用于执行 shell 命令的 MCP 服务。

本项目由 ChatWise 赞助，这是一个全面支持 MCP 的一体化大模型聊天机器人。

使用方法

手动配置
# stdio server
npx -y shell-command-mcp
JSON 配置
{
  "mcpServers": {
    "shell-command": {
      "command": "npx",
      "args": ["-y", "shell-command-mcp"],
      "env": {
        "ALLOWED_COMMANDS": "cat,ls,echo"
      }
    }
  }
}
允许的命令

使用 ALLOWED_COMMANDS 环境变量明确允许此服务运行的命令，各命令之间用 , 分隔。你可以使用 * 允许任何命令，但这可能存在危险。

许可证

MIT。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。