cli-mcp-server 的安装和配置教程

项目基础介绍

cli-mcp-server 是一个基于 Python 语言的开源项目，它提供了一个安全的 Model Context Protocol (MCP) 服务器实现，用于执行受控的命令行操作。该项目包含了严格的安全特性，例如命令白名单、路径验证以及执行控制等，非常适合在保持安全的同时为大型语言模型应用提供受控的 CLI 访问。

项目使用的关键技术和框架

本项目主要使用 Python 3.10+ 版本，并依赖 MCP 协议库来实现功能。它通过环境变量进行配置，支持异步操作，并能够防止壳操作符注入等安全问题。

准备工作

在开始安装 cli-mcp-server 之前，请确保您的系统中已安装以下环境和依赖：

• Python 3.10 或更高版本
• MCP 协议库

安装步骤

1. 克隆项目仓库： 使用 Git 命令将项目克隆到本地环境。

   git clone https://github.com/MladenSU/cli-mcp-server.git
   

2. 安装依赖： 进入项目目录，使用 pip 安装项目所需的依赖。

   cd cli-mcp-server
   pip install -r requirements.txt
   

3. 设置环境变量： 根据项目需求，设置相应的环境变量。以下是一些基本的环境变量配置示例：

   export ALLOWED_DIR="/your/desired/dir"
   export ALLOWED_COMMANDS="ls,cat,pwd"
   export ALLOWED_FLAGS="-l,-a,--help"
   export MAX_COMMAND_LENGTH="1024"
   export COMMAND_TIMEOUT="30"
   export ALLOW_SHELL_OPERATORS="false"
   

4. 运行项目： 使用以下命令启动 MCP 服务器。

   python cli_mcp_server.py
   

5. 配置 CLI MCP 服务器（可选）： 如果您需要将 CLI MCP 服务器与 Claude Desktop 配合使用，您需要将其配置添加到 Claude 的配置文件中。具体步骤如下：

   • 打开 ~/Library/Application Support/Claude/claude_desktop_config.json 文件。
   • 添加相应的服务器配置段。

   配置示例：

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

完成以上步骤后，您的 cli-mcp-server 应该已经成功安装并配置完毕，可以开始使用了。如果在安装或配置过程中遇到任何问题，请参考项目的官方文档或向项目维护者寻求帮助。