CLI MCP Server

CLI MCP Server

site icon
2025.04.12 70
Python命令行操作安全控制开发效率
CLI MCP Server 是一个安全的模型上下文协议(MCP)服务器实现,用于执行受控的命令行操作,具有全面的安全特性。它适用于为LLM应用程序提供受控的CLI访问,同时保持安全性。
View on GitHub

Overview

基本能力

产品定位

CLI MCP Server 是一个安全的模型上下文协议(MCP)服务器实现,用于执行受控的命令行操作,具有全面的安全特性。它适用于为LLM应用程序提供受控的CLI访问,同时保持安全性。

核心功能

  • 🔒 安全的命令执行,具有严格的验证
  • ⚙️ 可配置的命令和标志白名单,支持'all'选项
  • 🛡️ 路径遍历预防和验证
  • 🚫 Shell操作符注入保护
  • ⏱️ 执行超时和长度限制
  • 📝 详细的错误报告
  • 🔄 异步操作支持
  • 🎯 工作目录限制和验证

适用场景

  • 为LLM应用程序提供受控的CLI访问
  • 在需要严格安全控制的命令行操作环境中使用

工具列表

  1. run_command: 执行白名单中的CLI命令,在允许的目录内。
  2. show_security_rules: 显示当前的安全配置和限制。

常见问题解答

  • 如何配置服务器?通过环境变量配置,如ALLOWED_DIRALLOWED_COMMANDS等。
  • 如何调试?推荐使用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 了解完整条款。