Command Execution MCP Server for Claude Desktop

基本能力

产品定位

Command Execution MCP Server 是一个安全的本地命令行执行工具，专为Claude Desktop设计，用于在受控环境中执行本地系统命令。

核心功能

• 安全命令执行：内置安全检查机制执行shell命令
• 工作目录支持：可在指定目录中执行命令
• 跨平台兼容：支持macOS和其他类Unix系统
• 错误处理：提供详细的命令执行反馈
• 执行限制：设置超时和缓冲区限制防止资源滥用

适用场景

• 通过AI助手执行本地系统命令
• 在特定目录下执行批处理操作
• 需要安全执行环境的管理任务

工具列表

1. execute-command
2. 执行shell命令，可指定工作目录

3. 参数：

   • command(必需)：要执行的shell命令
   • workingDirectory(可选)：命令执行的工作目录

4. simple-hello

5. 基本演示工具，返回问候语
6. 参数：
   • name(可选)：问候名称(默认为"World")

常见问题

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

使用教程

使用依赖

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

安装教程

1. 安装依赖

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

1. 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. 确保Node.js和npm已正确安装
2. 验证依赖安装是否成功
3. 检查配置文件路径和内容是否正确
4. 尝试执行简单命令测试功能

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

许可证

该项目遵循 MIT 开源许可条款。