MCP Command Server

MCP Command Server

site icon
2025.03.25 0
Rust远程命令执行自动化运维开发效率
MCP Command Server 是一个基于 JSON-RPC 2.0 规范的远程命令执行服务,提供安全的容器化接口。其主要功能包括通过 JSON-RPC API 执行远程命令、基于模式的安全验证、内置 API 文档以及企业级部署配置。该服务适用于需要安全远程命令执行的场景,如自动化运维、远程服务器管理等。
View on GitHub

Overview

基本能力

产品定位

MCP Command Server 是一个安全、容器化的远程命令执行接口,提供 JSON-RPC 2.0 规范的 API,适用于自动化运维和远程服务器管理。

核心功能

  • JSON-RPC 2.0 API: 标准化的命令执行接口
  • 命令安全: 基于模式的命令过滤,防止潜在有害操作
  • 自文档化: 内置 /context 端点提供 Markdown 格式的文档
  • 容器化: 提供 Docker 配置,支持快速部署
  • 生产就绪: 安全设计,支持非 root 用户执行
  • 开发者友好: 提供完整的 Postman 测试集合

适用场景

  • 自动化运维
  • 远程服务器管理
  • 安全命令执行

工具列表

  • Docker: 用于容器化部署
  • Postman: 用于 API 测试
  • curl: 用于命令行测试

常见问题解答

  • 如何防止有害命令执行? 通过 exclude.yaml 文件配置命令排除模式。
  • 如何获取 API 文档? 访问 /context 端点获取 Markdown 格式的文档。

使用教程

使用依赖

  • Docker 和 Docker Compose
  • Git(用于克隆仓库)

安装教程

使用 Docker(推荐)

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp_command_server.git cd mcp_command_server
  2. 启动服务: bash docker-compose up -d
  3. 服务将在 http://localhost:3030 可用

从源码构建

  1. 安装 Rust(推荐 1.74+): bash curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  2. 克隆并构建项目: bash git clone https://github.com/yourusername/mcp_command_server.git cd mcp_command_server cargo build --release
  3. 运行服务: bash ./target/release/mcp_command_server

调试方式

测试基本功能

# 测试 context 端点
curl http://localhost:3030/context

# 执行简单命令
curl -X POST -H "Content-Type: application/json" -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "command/get",
  "params": {
    "command": "echo \"Hello World\""
  }
}' http://localhost:3030/

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。