Linux Command MCP (模型上下文协议)

概述

Linux Command MCP 是一个基于模型上下文协议（MCP）构建的远程命令执行系统，允许安全且标准化地执行 Linux 命令。

Claude Desktop MCP 服务器配置

配置理解

MCP 服务器在 claude_desktop_config.json 文件中进行配置，通常位于 ~/.config/Claude/claude_desktop_config.json。

配置结构

"mcpServers": {
  "server-name": {
    "command": "node|npx|uvx",
    "args": ["特定于服务器的参数"],
    "env": {
      "可选环境变量": "值"
    }
  }
}

Linux Command MCP 服务器配置

"linux-command": {
  "command": "node",
  "args": [
    "/完整路径/to/linux-command-mcp/server/dist/index.js"
  ]
}

配置解释

• "command"：指定执行器（node，npx，uvx）
• "args"：服务器可执行文件的完整路径
• 确保路径是到你的 index.js 的绝对路径

重要配置提示

• 始终使用完整的绝对路径
• 验证文件权限
• 确保指定的文件是可执行的

先决条件

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

安装

1. 克隆仓库

git clone <仓库地址>
cd linux-command-mcp

2. 安装服务器依赖

cd server
npm install
npm run build

3. 安装客户端依赖

cd ../client
npm install
npm run build

使用

启动服务器

1. 导航到服务器目录

cd server

2. 使用 PM2 启动

npm run pm2:start

使用客户端

可用命令：

1. exec <命令> - 执行 Linux 命令
2. list [目录] - 列出目录内容
3. help - 显示此帮助
4. exit - 退出客户端

直接执行命令：

# 在客户端目录下
npm start 
exec "ls -l"
exec "list /home"
exec "uname -a"

Sudo 命令

重要提示：Linux Command MCP 服务器不能执行交互式命令如 sudo。

当你需要运行 sudo 命令时：

1. 在服务器上手动执行命令
2. 复制并粘贴输出结果
3. 分享结果

故障排除

• 确保 PM2 正在运行：pm2 list
• 查看服务器日志：pm2 logs linux-command-mcp-server
• 验证服务器和客户端构建

在 Claude Desktop 中使用 Linux 命令

示例交互

这里是一些如何请求 Claude 运行 Linux 命令的安全通用示例：

1. 检查系统信息

   • "你能显示 Linux 内核版本吗？"

   $ uname -r
   

2. 列出目录内容

   • "显示家目录的内容"

   $ ls ~
   

3. 检查可用磁盘空间

   • "这个系统的磁盘使用情况是什么？"

   $ df -h
   

4. 查看系统运行时间

   • "这个系统已经运行了多久？"

   $ uptime
   

5. 检查网络接口

   • "有哪些可用的网络接口？"

   $ ip addr
   

6. 系统内存信息

   • "你能显示内存使用情况吗？"

   $ free -h
   

重要使用指南

• 隐私：仅运行不会泄露敏感信息的命令
• 安全：避免修改系统配置的命令
• 范围：专注于提供信息和诊断的命令

应避免的操作

❌ 不要运行以下命令：

• 泄露个人文件名或路径
• 包含敏感系统配置
• 修改系统设置
• 需要 sudo 或 root 权限

示例对话

用户："你能检查一下 Linux 内核版本吗？"

Claude：当然！我将运行命令来显示 Linux 内核版本。

$ uname -r
5.15.0-91-generic

这个内核正在运行 Ubuntu 22.04.3 LTS。

安全注意事项

• 仅在受信任的网络上运行
• 限制对服务器的访问
• 对命令执行保持谨慎

安全与最佳实践

• 始终注意你请求的信息
• 使用提供系统级非敏感信息的命令
• 当有疑问时，请让 Claude 解释命令的目的

贡献

通过以下方式改进和扩展 Linux Command MCP：

• 添加更多安全通用的命令示例
• 增强文档
• 提出命令执行的改进建议

许可证

MIT 许可证

联系方式

• 邮件：xkiranj.1980@gmail.com

• 区块链：0xkiran.eth

  • Ethereum：0x67F367edb83d8fdF48E7E7Cfcb35183e746c292c
  • Bitcoin：bc1q688np092y8raxag5e6573chrcgck5756yv476v