Command Execution MCP Server for Claude Desktop

面向 Claude Desktop 的命令执行 MCP 服务

概述

命令执行 MCP（Model Context Protocol）服务是一种安全、受控的工具，可让 Claude 直接在本地系统上执行 shell 命令。此服务通过 Claude 的界面提供了一种安全灵活的方式，让你与计算机的命令行进行交互。

主要功能

• 安全执行命令：运行 shell 命令，并内置安全检查
• 支持工作目录：在指定目录中执行命令
• 跨平台兼容：适用于 macOS 和其他类 Unix 系统
• 全面的错误处理：针对命令执行提供详细反馈
• 超时和缓冲区限制：防止命令失控或过度占用资源

安全措施

此服务实现了多层安全机制：

1. 阻止危险命令

   • 阻止执行 rm -rf、sudo 等可能有害的命令
   • 阻止可能危及系统完整性的命令

2. 执行限制

   • 最长执行时间：30 秒
   • 最大输出缓冲区：1MB
   • 验证工作目录是否存在

支持的工具

1. execute-command

执行 shell 命令，可选指定工作目录。

参数：

• command（必填）：要执行的 shell 命令
• workingDirectory（可选）：指定执行命令的目录

Claude 中的使用示例：

execute-command with command="ls -la" and workingDirectory="/Users/yourusername/Documents"

2. simple-hello

用于演示的基础工具，可返回问候语。

参数：

• name（可选）：问候对象的名称（默认为 “World”）

Claude 中的使用示例：

simple-hello with name="Claude"

安装

1. 前置条件

• Node.js（v16 或更高版本）
• Claude Desktop
• npm（Node 包管理器）

2. 安装依赖项

cd /path/to/command-execution-tool
npm install @modelcontextprotocol/sdk

3. Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置文件中：

位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

配置块：

{
  "mcpServers": {
    "command-execution": {
      "command": "node",
      "args": [
        "/full/path/to/command-execution-tool.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

**重要提示：**将 /full/path/to/command-execution-tool.js 替换为脚本的实际路径。

使用指南

• 谨慎使用：只运行你了解的命令
• 安全优先：此工具会阻止明显危险的命令
• 工作目录：指定工作目录，以便更可控地执行命令

限制

• 不支持交互式命令
• 命令最长执行时间为 30 秒
• 输出限制为 1MB
• 某些系统关键命令会被阻止

参与贡献

欢迎贡献！请在 GitHub 仓库中提交拉取请求或创建议题。

许可证

MIT 许可证

支持

如有问题或功能请求，请提交 GitHub 议题。