CLI MCP Server

CLI MCP Server

site icon
2025.01.09 0
Python命令行操作安全执行开发效率
plurigrid_juvix-mcp-server 是一个安全的模型上下文协议(MCP)服务器实现,专门用于执行受控的命令行操作,并提供全面的安全功能。该服务器适用于需要安全执行命令行操作的场景,特别是在与大型语言模型(LLM)应用程序集成时。
View on GitHub

Overview

基本能力

产品定位

plurigrid_juvix-mcp-server 是一个安全的命令行操作执行服务器,旨在为LLM应用程序提供受控的命令行访问,同时确保安全性。

核心功能

  • 安全命令执行:通过严格的验证机制执行命令。
  • 可配置的命令和标志白名单:支持配置允许的命令和标志,或设置为允许所有命令和标志。
  • 路径遍历预防和验证:确保所有路径操作在允许的目录内进行。
  • Shell操作符注入保护:防止Shell操作符(如&&, |, >, >>)的注入。
  • 执行超时和长度限制:限制命令执行时间和命令字符串长度。
  • 详细错误报告:提供详细的错误信息,便于调试。
  • 异步操作支持:支持异步命令执行。
  • 工作目录限制和验证:限制命令执行的工作目录。

适用场景

  • 为LLM应用程序提供安全的命令行操作接口。
  • 在需要严格控制命令行操作的环境中执行命令。
  • 开发需要与命令行交互的安全应用程序。

工具列表

  1. run_command:执行白名单中的CLI命令,支持在允许的目录内执行命令。
  2. 输入:单个命令字符串(如 'ls -l' 或 'cat file.txt')。
  3. 安全限制:不支持Shell操作符,命令和标志必须在白名单中(除非设置为允许所有)。
  4. show_security_rules:显示当前的安全配置和限制,包括工作目录、允许的命令和标志、安全限制等。

常见问题解答

  • 如何配置服务器:通过环境变量配置,如 ALLOWED_DIR(必需)、ALLOWED_COMMANDSALLOWED_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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。