mcp-server-commands

工具

工具供 LLM 发起请求，例如 Claude Desktop 应用。 Claude Sonnet 3.5 能够智能地使用这两种工具，这让我感到惊喜。

• run_command - 运行命令，例如 hostname 或 ls -al 或 echo "hello world" 等
  • 将 STDOUT 和 STDERR 作为文本返回
• run_script - 运行脚本！（例如 fish、bash、zsh、python）
  • 让你的 LLM 运行它编写的代码！
  • 脚本通过 STDIN 传递
  • run_script == run_command + 通过 STDIN 传递的脚本
  • Claude 在这方面非常有创造力，例如使用 cat 作为解释器来创建新文件！

[!WARNING] 请谨慎要求此服务器运行的内容！ 在 Claude Desktop 应用中，使用 Approve Once（而不是 Allow for This Chat），以便您可以审查每个命令，如果您不信任该命令，请使用 Deny。 权限由运行服务器的用户决定。 请勿使用 sudo 运行。

视频演示

<a href="https://youtu.be/0-VPu1Pc18w"><img src="https://img.youtube.com/vi/0-VPu1Pc18w/maxresdefault.jpg" width="480" alt="YouTube Thumbnail"></a>

提示语

提示语供用户包含在聊天记录中，例如通过 Zed 的斜杠命令（在其 AI Chat 面板中）

• run_command - 生成带有命令输出的提示消息

开发

安装依赖项：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

使用已发布的 npm 包

已作为 mcp-server-commands 发布到 npm，使用此 workflow

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

使用本地构建（仓库检出）

{
  "mcpServers": {
    "mcp-server-commands": {
      // 因为 index.js 中的 shebang 而起作用
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

日志记录

Claude Desktop 应用将日志写入 ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log

默认情况下，仅记录重要消息（即错误）。 如果您想查看更多消息，请在配置服务器时将 --verbose 添加到 args。

顺便说一句，日志被写入 STDERR，因为这是 Claude Desktop 路由到日志文件的位置。 将来，我希望格式良好的日志消息通过 STDIO 传输写入 MCP 客户端（注意：不是 Claude Desktop 应用）。

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。