返回 MCP 目录
public公开dns本地运行

linux-command-mcp

Linux Command MCP是一个基于Model Context Protocol(MCP)的远程Linux命令执行系统,支持安全、标准化的命令操作。

article

README

🚀 Linux 命令 MCP(模型上下文协议)

Linux Command MCP 是一个基于 Model Context Protocol (MCP) 构建的远程命令执行系统,它能够支持安全且标准化地执行 Linux 命令,为用户提供了便捷、高效的命令执行解决方案。

🚀 快速开始

先决条件

使用本系统前,需要确保满足以下条件:

  • 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
  1. 使用以下命令启动 MCP 代理
node dist/index.js

客户端使用说明

要在 Claude Desktop 中使用此 MCP 服务器,请参考相关文档。

✨ 主要特性

  • 基于 Model Context Protocol (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": {
      "OPTIONAL_ENVIRONMENT_VARIABLES": "值"
    }
  }
}

Linux Command MCP 服务器配置

"linux-command": {
  "command": "node",
  "args": [
    "/full/path/to/linux-command-mcp/server/dist/index.js"
  ]
}

配置说明

  • "command":指定执行器(nodenpxuvx
  • "args":服务器可执行文件的完整路径
  • 确保路径是到 index.js 的绝对路径

重要配置提示

⚠️ 重要提示

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

💻 使用示例

基础用法

MCP 代理将在 localhost:3000 启动,并支持以下操作:

检查当前目录

curl http://localhost:3000/mcp/currentdir

执行命令并获取结果

curl -X POST "http://localhost:3000/mcp/command" -H "Content-Type: application/json" -d '{"command":"ls"}'

📚 详细文档

如需更详细的使用说明,请参考相关文档。

📄 许可证

文档中未提及相关许可证信息。

📞 联系方式

  • 邮箱:xkiranj.1980@gmail.com
  • 区块链地址:
    • Ethereum: 0x67F367edb83d8fdF48E7E7Cfcb35183e746c292c
    • Bitcoin: bc1q688np092y8raxag5e6573chrcgck5756yv476v
即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL,暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端