Tools

基本能力

产品定位

g0t4_mcp-server-commands 是一个为 LLMs 提供命令执行能力的 MCP 服务器，主要用于扩展 LLMs 的功能，使其能够运行系统命令和脚本。

核心功能

• run_command: 运行一个命令（如 hostname、ls -al、echo "hello world" 等），并返回 STDOUT 和 STDERR 作为文本。
• run_script: 运行一个脚本（如 fish、bash、zsh、python），允许 LLM 运行它编写的代码。脚本通过 STDIN 传递。

适用场景

• 在 Claude Desktop 应用中，允许 LLM 运行系统命令和脚本。
• 开发过程中，用于调试和测试 LLM 生成的代码。

工具列表

• run_command: 运行系统命令并返回输出。
• run_script: 运行脚本并返回输出。

常见问题解答

• 安全性警告: 请谨慎运行服务器请求的命令。在 Claude Desktop 应用中，使用 Approve Once（而不是 Allow for This Chat）来审查每个命令。
• 权限: 服务器的权限由运行服务器的用户决定。不要使用 sudo 运行。

使用教程

使用依赖

安装依赖：

npm install

安装教程

1. 构建服务器：

npm run build

1. 开发时使用自动重建：

npm run watch

1. 在 Claude Desktop 中添加服务器配置：
2. MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. Windows: %APPDATA%/Claude/claude_desktop_config.json

使用发布的 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

Inspector 将提供一个 URL，用于在浏览器中访问调试工具。

日志

默认情况下，只有重要消息（如错误）会被记录。如需查看更多消息，请在配置服务器时添加 --verbose 到 args。 日志写入 STDERR，因为 Claude Desktop 将其路由到日志文件。

许可证

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