JinDaGe - linux-command-mcp MCP Details

article

README

🚀 Linux 命令 MCP（模型上下文协议）

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

🚀 快速开始

先决条件

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

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

安装步骤

克隆仓库

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

安装服务器依赖项

cd server
npm install
npm run build

安装客户端依赖项

cd ../client
npm install
npm run build

启动服务器

cd server

使用以下命令启动 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"：指定执行器（node、npx、uvx）
"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

linux-command-mcp