cli-executor-mcp 0.1.0

MCP服务器，用于执行CLI命令进行系统部署和管理

CLI Executor MCP

基于MCP的CLI命令执行服务器，用于系统部署和管理

概述

CLI Executor MCP是一个基于Model Context Protocol (MCP)的服务器，它提供了执行CLI命令的工具，使LLM（如Claude）能够执行系统命令、部署应用程序和管理系统。

主要功能：

• 执行单个CLI命令
• 执行多行脚本
• 列出目录内容
• 获取系统信息
• 提供部署应用的提示模板

安装

从源代码安装

# 克隆仓库
git clone https://github.com/yourusername/cli-executor-mcp.git
cd cli-executor-mcp

# 安装
pip install -e .

使用pip安装

pip install cli-executor-mcp

使用方法

作为命令行工具运行

# 使用stdio传输（默认）
cli-executor-mcp

# 使用SSE传输
cli-executor-mcp --transport sse

# 启用调试模式
cli-executor-mcp --debug

在Claude Desktop中安装

使用MCP CLI工具安装：

mcp install cli-executor-mcp

或者从源代码安装：

cd cli-executor-mcp
mcp install .

工具和资源

工具

CLI Executor MCP提供以下工具：

1. execute_command - 执行单个CLI命令

   • 参数：
     • command: 要执行的命令
     • working_dir: (可选) 执行命令的工作目录

2. execute_script - 执行多行脚本

   • 参数：
     • script: 要执行的脚本内容（多行命令）
     • working_dir: (可选) 执行脚本的工作目录

3. list_directory - 列出指定目录的内容

   • 参数：
     • path: (可选) 要列出内容的目录路径

资源

1. system://info - 获取系统信息

提示

1. deploy_app - 创建一个部署应用的提示
   • 参数：
     • app_name: 应用名称
     • target_dir: 目标目录

示例

执行命令

# 使用MCP客户端调用工具
result = await session.call_tool("execute_command", {"command": "ls -la"})
print(result)

执行脚本

# 使用MCP客户端调用工具
script = """
mkdir -p test_dir
cd test_dir
echo "Hello, World!" > test.txt
ls -la
"""
result = await session.call_tool("execute_script", {"script": script})
print(result)

获取系统信息

# 使用MCP客户端读取资源
content, mime_type = await session.read_resource("system://info")
print(content)

安全注意事项

CLI Executor MCP允许执行任意系统命令，这可能带来安全风险。在生产环境中使用时，请确保：

1. 限制服务器的访问权限
2. 在受限环境中运行服务器（如容器或沙箱）
3. 实施命令白名单或其他安全措施

许可证

MIT