Secure Command Executor MCP Server

Secure Command Executor MCP Server

site icon
2025.03.30 0
JavaScript命令执行系统管理安全工具开发效率
Secure Command Executor MCP Server 是一个强大的命令执行 MCP 服务,旨在安全地管理和执行系统命令,提供安全检查、日志记录和命令管理功能。它支持命令执行、危险命令警告、命令管理、日志轮转和查询工具等功能。适用于需要安全执行系统命令的场景,如自动化脚本管理、系统维护和开发环境管理。
View on GitHub

Overview

基本能力

产品定位

Secure Command Executor MCP Server 是一个用于安全执行和管理系统命令的 MCP 服务,适用于开发、运维和自动化任务管理。

核心功能

  • 命令执行:支持执行系统命令并传递可选参数。
  • 安全检查:对危险命令进行警告并要求确认。
  • 命令管理:支持添加、更新、删除、启用或禁用命令。
  • 日志记录:提供每日日志轮转功能,记录详细的操作信息。
  • 查询工具:支持查询可用命令和日志,并可应用过滤器。

适用场景

  • 自动化脚本管理
  • 系统维护任务
  • 开发环境管理
  • 危险命令的安全执行

工具列表

  • 命令执行工具:通过 API 或命令行执行系统命令。
  • 命令管理工具:支持动态管理命令列表。
  • 日志查询工具:支持按条件查询日志记录。

常见问题解答

  • 如何配置危险命令?commands.json 中设置 dangeroustrue 并配置确认提示。
  • 如何修改默认端口? 使用 --port 参数或设置 PORT 环境变量。
  • 日志存储在哪里? 日志存储在指定的目录中,每日轮转生成新文件。

使用教程

使用依赖

安装以下依赖:

npm install minimist
npm install @modelcontextprotocol/sdk
npm install zod

安装教程

  1. 克隆仓库:
git clone https://github.com/HappyAny/secure-command-executor-mcp-server.git
cd secure-command-executor-mcp-server
  1. 安装依赖(见上文)。
  2. 配置服务:
  3. 修改 commands.json 定义可用命令。
  4. 设置环境变量(可选)。

启动服务

node index.js --file commands.json --logs logs --port 3000

调试方式

  • 执行命令
curl -X POST http://localhost:3000/execute -H "Content-Type: application/json" -d '{"command": "dir", "args": "/w"}'
  • 查询命令
curl -X GET http://localhost:3000/queryCommands?filter=enabled&detailed=true
  • 查询日志
curl -X GET http://localhost:3000/queryLogs?limit=50&filter=failed

许可证

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