# mcollina
## 基本信息
- Slug: `mcollina-perm-shell-mcp`
- Source: modelscope
- Publisher: @mcollina/perm-shell-mcp
- Categories: shell-access / command-line / os-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@mcollina/perm-shell-mcp
## 简介
暂无描述。
## MCP Server 详情

# 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