MCP Server Commands

🚀 工具

本工具用於向大語言模型（LLMs）發起請求，具體是針對 Claude 桌面應用程序。Claude Sonnet 3.5 能夠智能運用這兩種工具，著實令人驚喜。

✨ 主要特性

• run_command：可運行一條命令，例如 hostname、ls -al 或 echo "hello world" 等。該命令會返回標準輸出（STDOUT）和標準錯誤輸出（STDERR）的文本內容。
• run_script：用於運行腳本，支持 fish、bash、zsh、python 等腳本類型。此功能可讓大語言模型執行其編寫的代碼，腳本通過標準輸入（STDIN）傳遞。實際上，run_script 等同於 run_command 加上腳本通過 STDIN 傳遞。Claude 已經極具創意地運用了該功能，例如使用 cat 作為解釋器來創建新文件。

⚠️ 重要提示

對於讓服務器運行的內容務必小心！在 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。