Tools

基本能力

产品定位

mcp-server-commands 是一个为大型语言模型（LLM）提供命令执行能力的服务，使 LLM 能够请求运行系统命令和脚本。

核心功能

• run_command: 运行系统命令（如 hostname、ls -al 等），返回 STDOUT 和 STDERR 作为文本
• run_script: 运行脚本（支持 bash、fish、zsh、python 等），脚本通过 STDIN 传递
• 与 Claude Desktop 应用集成，提供命令执行功能

适用场景

• 让 LLM 执行它编写的代码
• 通过 LLM 自动化执行系统命令
• 开发过程中快速测试命令和脚本

工具列表

• run_command: 执行系统命令
• run_script: 执行脚本（本质上是 run_command + 通过 STDIN 传递脚本）

常见问题解答

• 安全问题：建议使用 "Approve Once" 而非 "Allow for This Chat"，以便审查每个命令
• 权限问题：命令以运行服务器的用户权限执行，不要使用 sudo
• 日志记录：默认只记录重要消息，可通过 --verbose 参数获取更多日志

使用教程

使用依赖

npm install

安装教程

1. 构建服务器：

npm run build

1. 开发时自动重建：

npm run watch

1. 与 Claude Desktop 集成： 在配置文件中添加服务器配置（MacOS 和 Windows 路径不同）

使用 npm 包：

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"]
    }
  }
}

使用本地构建：

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

调试方式

使用 MCP Inspector 进行调试：

npm run inspector

许可证

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