Linux Command MCP (Model Context Protocol)

基本能力

产品定位

Linux Command MCP 是一个远程命令执行系统，专注于安全、标准化地执行 Linux 命令，特别适用于开发者和系统管理员进行系统信息查询和诊断。

核心功能

1. 远程命令执行：通过 MCP 协议安全执行 Linux 命令。
2. 目录内容列表：可以列出指定目录的内容。
3. 系统信息查询：支持查询系统信息如内核版本、磁盘使用情况、网络接口等。
4. 安全限制：避免执行敏感或修改系统配置的命令，特别是禁止执行需要 sudo 的命令。

适用场景

1. 开发环境调试：快速查询系统信息，辅助开发调试。
2. 系统监控：定期检查系统状态如磁盘空间、内存使用等。
3. 远程协助：在受控环境中协助用户执行非敏感命令。

工具列表

1. exec：执行指定的 Linux 命令。
2. list：列出目录内容。
3. help：显示帮助信息。
4. exit：退出客户端。

常见问题解答

1. 无法执行 sudo 命令：设计上不支持交互式命令如 sudo，需手动执行后复制结果。
2. PM2 未运行：使用 pm2 list 检查 PM2 状态。
3. 服务器日志查看：通过 pm2 logs linux-command-mcp-server 查看日志。

使用教程

使用依赖

• Node.js (v18.x 或更高版本)
• npm
• PM2 (用于进程管理)

安装教程

1. 克隆仓库

git clone <repository-url>
cd linux-command-mcp

1. 安装服务器依赖

cd server
npm install
npm run build

1. 安装客户端依赖

cd ../client
npm install
npm run build

调试方式

1. 启动服务器

cd server
npm run pm2:start

1. 使用客户端

cd ../client
npm start
exec "ls -l"

1. 检查 PM2 状态

pm2 list

1. 查看服务器日志

pm2 logs linux-command-mcp-server

许可证

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