Shell Executor MCP

MCPAI代理

提供方 AceDarkknight

AI代理 未标注 Token 社区 / 第三方

基于MCP协议的分布式Shell命令执行系统,支持集群分发、安全控制和故障转移。

一句话选型结论

按资料字段整理

Shell Executor MCP 属于AI代理类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

分布式系统Go本地部署Shell命令执行集群管理安全控制MCP协议

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Shell Executor MCP当前 未标注 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AceDarkknight上游标注的维护方 AceDarkknight
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.7 KB
来自项目仓库与上游目录的原文,未做删改

Shell Executor MCP System

基于 MCP (Model Context Protocol) 的分布式 Shell 命令执行系统,支持集群分发和安全控制。

项目概述

本项目实现了一个支持集群分发和安全控制的 Shell 命令执行系统。Client 端可以连接到任意 Server 节点,该节点将作为 Coordinator 自动将命令分发给集群中的所有节点,并聚合返回结果。

主要特性

  • MCP 协议支持:基于 github.com/modelcontextprotocol/go-sdk 实现 MCP Server 标准接口
  • 集群分发:支持多节点并发执行命令,自动聚合结果
  • 安全控制:内置黑名单机制,拦截高危命令
  • 故障转移:Client 端支持多服务器配置,自动故障转移
  • 结果聚合:相同结果的节点自动合并,减少网络传输
  • 结构化日志:使用 zap 进行结构化日志记录,支持日志轮转和级别控制

项目结构```

shell-executor-mcp/
├── cmd/ # 可执行程序
│ ├── client/ # MCP 客户端
│ │ └── main.go
│ └── server/ # MCP 服务器
│ └── main.go
├── internal/ # 内部模块
│ ├── config/ # 配置管理
│ │ └── config.go
│ ├── dispatch/ # 集群分发器
│ │ └── dispatcher.go
│ ├── executor/ # 命令执行器
│ │ └── executor.go
│ ├── logger/ # 日志管理
│ │ └── logger.go
│ └── security/ # 安全卫士
│ └── guard.go
├── pkg/ # 公共包
│ └── configs/ # 客户端配置
│ └── client_config.go
├── docs/ # 文档
│ ├── requirements.md # 需求文档
│ ├── architecture.md # 架构文档
│ ├── api.md # API 接口文档
│ └── plan/ # 开发计划
└── scripts/ # 测试脚本
├── test_single_node.sh
├── test_cluster.sh
└── README.md


## 快速开始

### 前置条件

- Go 1.25.1 或更高版本
- 端口 8080(单节点)或 8080-8082(集群)可用

### 构建项目```bash
# 构建服务器
cd cmd/server
go build -o server.exe main.go
cd ../..

# 构建客户端
cd cmd/client
go build -o client.exe main.go
cd ../..

配置文件

服务器配置 (server_config.json)```json

{
"port": 8080,
"node_name": "node-01",
"peers": [
"http://localhost:8081",
"http://localhost:8082"
],
"cluster_token": "your-cluster-token",
"security": {
"blacklisted_commands": ["rm", "mkfs", "shutdown", "reboot"],
"dangerous_args_regex": [
"rm\s+-[a-zA-Z]r[a-zA-Z]\s+/"
]
},
"tls": {
"enabled": true,
"cert_file": "",
"key_file": ""
},
"log": {
"level": "info",
"log_dir": ".",
"max_size": 100,
"max_backups": 3,
"max_age": 28,
"compress": false
}
}


**日志配置说明**:
- `level`: 日志级别,可选值为 `debug`, `info`, `warn`, `error`,默认为 `info`
- `log_dir`: 日志文件目录,默认为当前目录
- `max_size`: 单个日志文件最大大小(MB),默认为 100MB
- `max_backups`: 保留的旧日志文件最大数量,默认为 3 个
- `max_age`: 保留旧日志文件的最大天数,默认为 28 天
- `compress`: 是否压缩旧日志文件,默认为 `false`

**TLS 配置说明**:
- `enabled`: 是否启用 HTTPS,默认为 `true`
- `cert_file`: TLS 证书文件路径,为空则自动生成自签证书
- `key_file`: TLS 私钥文件路径,为空则自动生成自签证书

TLS 也可通过环境变量或命令行参数启用:```bash
# 环境变量(注意 MCP_ 前缀)
export MCP_TLS_ENABLED=true

# 命令行参数
./shell-executor-mcp-server --tls

> 重要提示:如果客户端与服务端之间存在跨子网网络设备(防火墙/IPS/WAF),强烈建议启用 TLS。
> 部分企业网络设备会对明文 HTTP body 进行深度包检测(DPI),匹配到命令注入特征
> (如 cat /etc/passwd、;、&&、/bin/ 等模式)后会静默丢弃连接,
> 导致请求超时。启用 TLS 后流量加密,DPI 无法检查请求内容,可彻底解决此问题。

客户端配置 (client_config.json)```json

{
"servers": [
{
"name": "primary-01",
"url": "https://localhost:8080/mcp"
},
{
"name": "backup-02",
"url": "https://localhost:8081/mcp"
}
],
"log": {
"level": "info",
"log_dir": ".",
"max_size": 100,
"max_backups": 3,
"max_age": 28,
"compress": false
}
}


> 服务端启用 TLS 后,客户端 URL 需从 `http://` 改为 `https://`。
> 使用自签证书时,客户端需通过 `WithInsecureSkipVerify()` 跳过证书验证。

**日志配置说明**:
- `level`: 日志级别,可选值为 `debug`, `info`, `warn`, `error`,默认为 `info`
- `log_dir`: 日志文件目录,默认为当前目录
- `max_size`: 单个日志文件最大大小(MB),默认为 100MB
- `max_backups`: 保留的旧日志文件最大数量,默认为 3 个
- `max_age`: 保留旧日志文件的最大天数,默认为 28 天
- `compress`: 是否压缩旧日志文件,默认为 `false`

### 启动服务器```bash
# 单节点模式
cmd/server/server.exe server_config.json

# 集群模式(在不同终端中启动多个节点)
cmd/server/server.exe node1_config.json
cmd/server/server.exe node2_config.json
cmd/server/server.exe node3_config.json

启动客户端```bash

cmd/client/client.exe client_config.json


### 使用示例```
Shell Executor MCP Client
Type 'exit' or 'quit' to exit
----------------------------------------
> echo Hello World
Executing: echo Hello World
Server response:
Summary: Executed on 1 nodes, 1 groups found

[Group 1] Count: 1 | Status: success
Output:
Hello World

Nodes: node-01

----------------------------------------
> hostname
Executing: hostname
Server response:
Summary: Executed on 3 nodes, 1 groups found

[Group 1] Count: 3 | Status: success
Output:
my-hostname

Nodes: node-01, node-02, node-03

----------------------------------------
> rm -rf /
Executing: rm -rf /
Server returned an error:
security violation: command 'rm' is blacklisted

----------------------------------------

测试

项目提供了自动化测试脚本:

单节点测试```bash

bash scripts/test_single_node.sh


### 集群测试```bash
bash scripts/test_cluster.sh

详细说明请参考 scripts/README.md。

架构设计

系统采用去中心化架构,任何接收到 Client 请求的 Server 节点自动承担 Coordinator 角色。

通信协议

  • Client → Server:MCP Streamable HTTP (/mcp),支持 TLS 加密
  • Server → Server:Internal HTTP JSON API

核心流程

  1. Client 连接到任意 Server 节点
  2. 该节点成为 Coordinator
  3. Coordinator 并发执行本地命令和分发到 Peer 节点
  4. Coordinator 聚合所有结果
  5. Coordinator 返回聚合结果给 Client

详细的架构设计请参考 docs/architecture.md。

安全特性

  • 黑名单机制:拦截黑名单中的命令
  • 正则匹配:支持正则表达式匹配危险参数
  • Token 鉴权:集群内部通信使用 Token 鉴权

API 文档

详细的 API 文档请参考 docs/api.md。

开发计划

开发计划和进度请参考 docs/plan/2026-01-19-implementation-plan.md。

技术栈

  • 语言:Go 1.25.1
  • MCP SDK:github.com/modelcontextprotocol/go-sdk v1.2.0
  • 日志库:go.uber.org/zap v1.27.1(结构化日志)
  • 日志轮转:gopkg.in/natefinch/lumberjack.v2 v2.2.1(日志文件轮转)
  • 传输协议:MCP Streamable HTTP

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request。

联系方式

如有问题或建议,请通过 GitHub Issues 联系。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Shell Executor MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Shell Executor MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Shell Executor MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Shell Executor MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Shell Executor MCP 能提供哪些能力?

资料显示能力标签包括 分布式系统、安全控制、Go、集群管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。