CommandExecution

🚀 命令执行 MCP 服务器 - Claude Desktop 版本

命令执行 MCP（模型上下文协议）服务器是一款安全且受控的工具，它能让 Claude 直接在您的本地系统上执行 shell 命令。通过该服务器，您可以借助 Claude 的界面，安全又灵活地与计算机的命令行进行交互。

🚀 快速开始

此服务器允许 Claude 直接在本地系统执行 shell 命令，为与计算机命令行交互提供了安全灵活的方式。使用前需完成安装和配置，具体步骤见下文。

✨ 主要特性

• 安全命令执行：具备内置安全检查的 shell 命令执行功能。
• 工作目录支持：可在特定目录中执行命令。
• 跨平台兼容性：适用于 macOS 和其他类 Unix 系统。
• 全面错误处理：提供详细的命令执行反馈。
• 超时和缓冲区限制：防止长时间运行或资源密集型的命令。

🔧 技术细节

服务器实现了多层安全保护：

1. 危险命令阻止
   • 防止执行可能具有危害性的命令，如 rm -rf、sudo 等。
   • 阻止会危及系统完整性执行的命令。
2. 执行限制
   • 最大执行时间：30 秒。
   • 最大输出缓冲区大小：1MB。
   • 验证工作目录存在性。

📦 安装指南

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 替换为您实际的脚本路径。

💻 使用示例

支持工具

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"

📚 详细文档

使用指南

• 谨慎行事：只运行您理解的命令。
• 安全第一：工具会阻止显然危险的命令。
• 工作目录：指定工作目录以获得更受控的执行环境。

局限性

• 不支持交互式命令。
• 最大命令执行时间是 30 秒。
• 输出限制为 1MB。
• 阻止一些系统关键命令。

贡献

欢迎贡献！请通过提交拉取请求或在 GitHub 仓库中打开问题。

支持

有关问题或功能请求，请在 GitHub 上打开一个问题。

📄 许可证

本项目采用 MIT 许可证。