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

2025-05-29 09:40:20作者：羿妍玫Ivan

项目基础介绍

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

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

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

准备工作

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

Python 3.10 或更高版本
MCP 协议库

安装步骤

克隆项目仓库： 使用 Git 命令将项目克隆到本地环境。
```
git clone https://github.com/MladenSU/cli-mcp-server.git
```
安装依赖： 进入项目目录，使用 pip 安装项目所需的依赖。
```
cd cli-mcp-server
pip install -r requirements.txt
```

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

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"

运行项目： 使用以下命令启动 MCP 服务器。
```
python cli_mcp_server.py
```

配置 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"
      }
    }
  }
}