CLI MCP Server

CLI MCP服务器

______________________________________________________________________

用于执行受控命令行操作的安全模型上下文协议（MCP）服务器实现 全面的安全功能。

______________________________________________________________________

目录

1. 概述
2. 特性
3. 配置
4. 可用工具

- 运行命令 - show_security_rules

1. 使用Claude Desktop

- 开发/未发布的服务器配置 - 已发布的服务器配置

1. 安全功能
2. 错误处理
3. 发展

- 先决条件 - 建筑与出版 - 调试

1. 许可证

______________________________________________________________________

概述

此MCP服务器支持安全的命令行执行，具有强大的安全措施，包括命令白名单、路径 验证和执行控制。非常适合在保持安全性的同时提供对LLM应用程序的受控CLI访问。

特性

• 🔒 通过严格验证确保命令执行的安全性
• ⚙️ 可配置的命令和标记白名单，带有“全部”选项
• 🛡️ 路径遍历预防和验证
• 🚫 外壳操作员注射保护
• ⏱️ 执行超时和长度限制
• 📝 详细的错误报告
• 🔄 异步操作支持
• 🎯 工作目录限制和验证

配置

使用环境变量配置服务器：

注：设置 ALLOWED_COMMANDS 或 ALLOWED_FLAGS “all”将分别允许任何命令或标志。

安装

通过以下方式自动安装Claude Desktop的CLI MCP服务器 史密瑟里:

npx @smithery/cli install cli-mcp-server --client claude

可用工具

运行命令

在允许的目录中执行白名单CLI命令。

输入架构：

{
  "command": {
    "type": "string",
    "description": "Single command to execute (e.g., 'ls -l' or 'cat file.txt')"
  }
}

安全说明：

• 默认情况下不支持Shell运算符（&&、|、>、>>），但可以通过启用 ALLOW_SHELL_OPERATORS=true
• 除非ALLOWED_Commands='all'，否则命令必须列入白名单
• 标志必须列入白名单，除非ALLOWED_Flags=“全部”
• 所有路径都被验证为在ALLOWED_DIR范围内

show_security_rules

显示当前安全配置和限制，包括：

• 工作目录
• 允许的命令
• 允许的标志
• 安全限制（最大命令长度和超时）

使用Claude Desktop

添加到您的 ~/Library/Application\ Support/Claude/claude_desktop_config.json:

开发/未发布的服务器配置

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "
/cli-mcp-server",
        "run",
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

已发布的服务器配置

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uvx",
      "args": [
        "cli-mcp-server"
      ],
      "env": {
        "ALLOWED_DIR": "",
        "ALLOWED_COMMANDS": "ls,cat,pwd,echo",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30",
        "ALLOW_SHELL_OPERATORS": "false"
      }
    }
  }
}

如果它不起作用或在UI中显示，请通过清除缓存 uv clean.

安全功能

• ✅ 使用“全部”选项执行白名单命令
• ✅ 使用“全部”选项进行标记验证
• ✅ 路径遍历预防和规范化
• ✅ 外壳操作员屏蔽（通过以下方式提供选择加入支持 ALLOW_SHELL_OPERATORS=true)
• ✅ 命令长度限制
• ✅ 执行超时
• ✅ 工作目录限制
• ✅ Symlink解析和验证

错误处理

服务器为以下对象提供详细的错误消息：

• 安全违规（CommandSecurityError）
• 命令超时（CommandTimeoutError）
• 命令格式无效
• 路径安全违规
• 执行失败（CommandExecutionError）
• 常规命令错误（CommandError）

发展

先决条件

• Python 3.10+
• MCP协议库

建筑与出版

准备分发包裹：

1. 同步依赖关系并更新锁文件：

   uv sync

1. 构建包分发：

   uv build

> 这将在 dist/ 目录。

1. 发布到PyPI：

   uv publish --token {{YOUR_PYPI_API_TOKEN}}

调试

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 随着 此命令：

npx @modelcontextprotocol/inspector uv --directory {{your source code local directory}}/cli-mcp-server run cli-mcp-server

启动后，检查器将显示一个URL，您可以在浏览器中访问该URL以开始调试。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

有关更多信息或支持，请在项目存储库上打开一个问题。