
CLI MCP Server

2025.01.09
0
Python命令行操作安全执行开发效率
plurigrid_juvix-mcp-server 是一个安全的模型上下文协议(MCP)服务器实现,专门用于执行受控的命令行操作,并提供全面的安全功能。该服务器适用于需要安全执行命令行操作的场景,特别是在与大型语言模型(LLM)应用程序集成时。
View on GitHub
Overview
基本能力
产品定位
plurigrid_juvix-mcp-server 是一个安全的命令行操作执行服务器,旨在为LLM应用程序提供受控的命令行访问,同时确保安全性。
核心功能
- 安全命令执行:通过严格的验证机制执行命令。
- 可配置的命令和标志白名单:支持配置允许的命令和标志,或设置为允许所有命令和标志。
- 路径遍历预防和验证:确保所有路径操作在允许的目录内进行。
- Shell操作符注入保护:防止Shell操作符(如&&, |, >, >>)的注入。
- 执行超时和长度限制:限制命令执行时间和命令字符串长度。
- 详细错误报告:提供详细的错误信息,便于调试。
- 异步操作支持:支持异步命令执行。
- 工作目录限制和验证:限制命令执行的工作目录。
适用场景
- 为LLM应用程序提供安全的命令行操作接口。
- 在需要严格控制命令行操作的环境中执行命令。
- 开发需要与命令行交互的安全应用程序。
工具列表
- run_command:执行白名单中的CLI命令,支持在允许的目录内执行命令。
- 输入:单个命令字符串(如 'ls -l' 或 'cat file.txt')。
- 安全限制:不支持Shell操作符,命令和标志必须在白名单中(除非设置为允许所有)。
- show_security_rules:显示当前的安全配置和限制,包括工作目录、允许的命令和标志、安全限制等。
常见问题解答
- 如何配置服务器:通过环境变量配置,如
ALLOWED_DIR
(必需)、ALLOWED_COMMANDS
、ALLOWED_FLAGS
等。 - 如何调试:推荐使用 MCP Inspector 进行调试。
使用教程
使用依赖
- Python 3.10+
- MCP protocol library
安装教程
通过Smithery自动安装:
npx @smithery/cli install cli-mcp-server --client claude
调试方式
使用MCP Inspector进行调试:
npx @modelcontextprotocol/inspector uv --directory {{your source code local directory}}/cli-mcp-server run cli-mcp-server