Command

基本能力

产品定位

Command 是一个 MCP 服务器实现，专注于为 AI 助手提供在指定目录中执行命令的能力。

核心功能

• 提供通用的 "command" 工具，允许执行各种 shell 命令
• 支持在配置的目录中执行命令
• 包含路径验证机制，确保只能访问授权的目录
• 支持跨平台（Unix 和 Windows）

适用场景

• AI 助手需要执行文件系统操作（如列出目录内容）
• AI 助手需要与版本控制系统（如 git）交互
• AI 助手需要在特定目录中执行构建或测试命令

工具列表

• command: 在指定工作目录中执行 shell 命令
• 参数:
  • command: 要执行的 shell 命令（如 "ls -la", "dir", "git status"）
  • workingDir: 命令执行的工作目录（必须是配置中允许的目录）

常见问题解答

• 安全性: 服务器只允许在配置的目录中执行命令，防止访问未授权目录
• 权限: 建议使用具有有限权限的专用用户运行服务器
• 跨平台: 提供 Unix shell 脚本和 Windows 批处理文件两种启动方式

使用教程

使用依赖

• Node.js (v16 或更高版本)
• npm (v7 或更高版本)

安装教程

1. 安装依赖:

npm install

1. 配置 Claude 配置文件（通常位于 ~/.config/claude/claude_desktop_config.json 或 ~/Library/Application Support/Claude/claude_desktop_config.json）:

{
  "mcpServers": {
    "command": {
      "command": "/path/to/command/start-server.sh",
      "args": [
        "/path/to/allowed/directory1",
        "/path/to/allowed/directory2",
        "/path/to/allowed/directory3"
      ]
    }
  }
}

Windows 用户使用:

{
  "mcpServers": {
    "command": {
      "command": "C:\\path\\to\\command\\start-server.bat",
      "args": [
        "C:\\path\\to\\allowed\\directory1",
        "C:\\path\\to\\allowed\\directory2",
        "C:\\path\\to\\allowed\\directory3"
      ]
    }
  }
}

调试方式

• 启动服务器:

npm start

• 开发模式（文件更改时自动重新加载）:

npm run dev

• 运行测试:

npm test

许可证

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