Linux Command MCP

🚀 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

2. 安裝服務器依賴項

cd server
npm install
npm run build

3. 安裝客戶端依賴項

cd ../client
npm install
npm run build

✨ 主要特性

• 基於 Model Context Protocol (MCP) 構建，支持安全且標準化地執行 Linux 命令。
• 可在 Claude Desktop 中進行配置和使用。

📦 安裝指南

用於 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 的絕對路徑

重要配置提示

⚠️ 重要提示

• 始終使用完整的絕對路徑
• 驗證文件權限
• 確保指定文件可執行

💻 使用示例

啟動服務器

基礎用法

1. 切換到服務器目錄

cd server

2. 使用以下命令啟動 MCP 代理：

node dist/index.js

客戶端使用說明

要在 Claude Desktop 中使用此 MCP 服務器，請參考相關文檔。

示例

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