MCP Command Server

🚀 MCP命令行服務器

MCP命令行服務器是基於Rust語言開發的遠程命令執行服務，具備高度安全性。它藉助JSON - RPC協議與客戶端通信，還內置強大的命令過濾系統，可有效防止惡意操作。

🚀 快速開始

MCP命令行服務器可通過Docker運行，也能在本地構建運行。

✨ 主要特性

• JSON - RPC接口：提供command.get接口，可執行命令並返回輸出結果。
• 強大的安全機制：內置命令過濾系統，能配置禁止執行的命令模式，對多種類型的危險命令進行限制。

📦 安裝指南

使用Docker運行

# 拉取鏡像
docker pull mcp/command-server:latest

# 運行容器
docker run -d --name mcp-server -p 8080:8080 mcp/command-server:latest

本地構建

1. 克隆項目倉庫。
2. 安裝Rust和Docker環境。
3. 構建鏡像：

cargo build && docker build -t mcp/command-server .

💻 使用示例

基礎用法

以下是使用JSON - RPC接口執行命令的示例。

// 請求參數
#[derive(serde::Serialize, serde::Deserialize)]
struct CommandParams {
    command: String,
    // 可選參數，是否顯示完整錯誤信息，默認false
    verbose: Option<bool>,
}

// 響應結果
#[derive(serde::Serialize, serde:: Deserialize)]
struct CommandOutput {
    stdout: String,
    stderr: String,
    exit_code: i32,
}

📚 詳細文檔

核心功能

JSON - RPC接口

• command.get(params: CommandParams) -> Result<CommandOutput>
  • 執行並返回命令的輸出結果。

命令參數結構

請求參數

#[derive(serde::Serialize, serde::Deserialize)]
struct CommandParams {
    command: String,
    // 可選參數，是否顯示完整錯誤信息，默認false
    verbose: Option<bool>,
}

響應結果

#[derive(serde::Serialize, serde:: Deserialize)]
struct CommandOutput {
    stdout: String,
    stderr: String,
    exit_code: i32,
}

安全機制

命令過濾系統

• 使用exclude.yaml文件配置禁止執行的命令模式：

  patterns:
    - "rm -rf"
    - regex: "^sudo\s+"
    - shell: "../*.sh"
  

禁止的命令分類

1. 系統修改類：apt, yum, etc.
2. 文件操作類：rm -rf, etc.
3. 系統控制類：shutdown, reboot, etc.
4. 權限變更類：chmod, sudo, etc.
5. 網絡操作類：wget, curl, etc.
6. 命令鏈式執行：&&, |, etc.
7. 腳本執行類：bash, python, etc.
8. 文件路徑穿越：../, etc.

項目結構

mcp_command_server/
├── .context                 # API文檔markdown
├── Cargo.toml               # Rust依賴管理
├── Dockerfile               # 多階段Docker構建文件
├── exclude.yaml             # 命令過濾配置
├── docker-compose.yml       # Docker Compose配置
├── src/
│   ├── main.rs              # 服務主程序
│   ├── command.rs           # 命令執行邏輯
│   ├── rpc.rs               # JSON-RPC處理模塊
│   └── validator.rs         # 命令驗證邏輯
└── docs/
    ├── README.md            # 文檔說明
    └── mcp_command_server.postman_collection.json  # Postman測試集合

開發指南

依賴項

• Rust：主要編程語言。
• tokio：異步運行時。
• warp：Web服務器框架。
• serde & serde_json：序列化/反序列化庫。
• serde_yaml：YAML文件解析。
• regex：正則表達式支持。

貢獻指南

1. 叉取倉庫。
2. 創建功能分支 (git checkout -b feature/amazing-feature)。
3. 提交更改 (git commit -m 'Add some amazing feature')。
4. 推送到遠程分支 (git push origin feature/amazing-feature)。
5. 提交Pull Request。

🔧 技術細節

本項目基於Rust語言開發，利用tokio作為異步運行時，warp作為Web服務器框架，實現了高效的異步處理。通過serde和serde_json庫進行JSON數據的序列化和反序列化，使用serde_yaml解析YAML配置文件。正則表達式庫regex用於命令過濾系統中的模式匹配。

📄 許可證

項目採用MIT許可證，詳細信息請查看LICENSE文件。

聯繫方式

• 郵件：support@mcp.com
• GitHub: https://github.com/mcp/command-server