工具

工具是用于 LLMs 请求的，即 Claude 桌面应用程序。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 桌面应用程序中，请使用 Approve Once（而不是 Allow for This Chat）以便你可以逐条审查每个命令，使用 Deny 如果你不信任该命令。 权限由运行服务器的用户决定。 请不要以 sudo 运行。

视频演示

提示

提示用于用户在聊天历史中包含的内容，即通过 Zed 的命令（在它的 AI 聊天面板中）

• run_command - 生成一条带有命令输出的消息

开发

安装依赖：

npm install

构建服务器：

npm run build

使用自动重建进行开发：

npm run watch

安装

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

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

使用已发布的 npm 包

发布到 npm 为 mcp-server-commands 使用这个 工作流

{
  "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 桌面应用程序将日志写入 ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log

默认情况下，只有重要的消息会被记录（即错误）。 如果你想查看更多消息，请在配置服务器时的 args 中添加 --verbose。

顺便说一下，日志是通过 STDERR 写入的，因为这是 Claude 桌面应用程序路由到日志文件的内容。 将来，我期望格式化良好的日志消息通过 STDIO 传输写入 MCP 客户端（注意：不是 Claude 桌面应用程序）。

调试

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

npm run inspector

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

以上是所有内容的完整中文翻译，仅返回翻译后的内容，没有其他无关信息。