PermShell MCP

一个用于执行带有权限通知的 shell 命令的 Model Context Protocol (MCP) 服务器。

特性

• 通过 growl 通知以显式权限执行 shell 命令
• 基于 Model Context Protocol 构建，适用于标准化的 LLM 工具
• 多重安全措施防止未经授权的命令执行
• 透明的权限对话框显示将要执行的确切命令

安装

bash

克隆仓库

git clone https://github.com/yourusername/perm-shell-mcp.git cd perm-shell-mcp

安装依赖

npm install

构建项目

npm run build

使用

作为独立工具

bash

直接启动服务器

npm start

与 Claude Desktop 一起使用

在您的 Claude Desktop 配置文件中添加以下配置：

json { "mcpServers": { "permshell": { "command": "node", "args": ["/path/to/perm-shell-mcp/dist/index.js"] } } }

可用工具

execute-command

以权限执行 shell 命令。

示例：

你能列出我的主目录中的文件吗？

system-info

检索系统信息，包括操作系统、运行时间、内存、磁盘和 CPU。

示例：

我的系统信息是什么？

安全性

• 所有命令都需要通过桌面通知获得显式权限
• 命令显示其工作目录以实现完全透明
• 超时限制防止失控进程
• 输入清理防止命令注入

开发

bash

以监视模式运行进行开发

npm run dev