Terminal

🚀 終端 MCP 服務器

這是一個藉助 Claude Desktop 來執行終端命令的模型上下文協議（MCP）服務器。它能讓你在特定環境下方便地執行各類終端操作，為開發和使用帶來便利。

🚀 快速開始

本服務器可通過 Claude Desktop 執行終端命令，你可以按照以下步驟進行操作，開啟使用之旅。

✨ 主要特性

• 🔹 可執行帶有參數和選項的任何終端命令。
• 🔹 能在保持狀態的同時於不同目錄間進行切換。
• 🔹 能夠獲取終端環境的相關信息。
• 🔹 可捕獲完整的輸出，包括標準輸出（stdout）、標準錯誤輸出（stderr）以及退出碼。
• 🔹 具備正確的錯誤處理和格式化機制。

📦 安裝指南

先決條件

• Node.js v18 或更高版本
• TypeScript
• Claude Desktop

安裝步驟

1. 克隆倉庫：

git clone https://github.com/stat-guy/terminal.git
cd terminal

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

📚 詳細文檔

本地開發環境設置

1. 創建或編輯您的 Claude Desktop 配置文件：
   • 在 macOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
   • 在 Windows 上：%APPDATA%\\Claude\\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "terminal": {
      "command": "node",
      "args": [
        "[PATH_TO_REPO]/dist/index.js"
      ],
      "env": {
        "PERMISSION_REQUIRED": "true"
      }
    }
  }
}

請將 [PATH_TO_REPO] 替換為您實際克隆的倉庫路徑。

2. 重新啟動 Claude Desktop

可用工具

execute_command

• 可執行任何終端命令。
• 支持帶有參數和選項的命令。
• 能捕獲完整的輸出和退出碼。

change_directory

• 可更改當前工作目錄。
• 在命令執行之間保持狀態。
• 支持相對路徑和絕對路徑。

get_current_directory

• 獲取當前工作目錄的路徑。

get_terminal_info

• 獲取終端環境的相關信息。
• 顯示殼層、用戶、平臺以及最近的命令歷史記錄。

💻 使用示例

基礎用法

讓 Claude 執行終端命令，例如：

你能檢查我的當前目錄中有何文件嗎？
-> 執行：ls -la

你能告訴我當前目錄是什麼？
-> 執行：pwd

你能切換到下載文件夾嗎？
-> 執行：cd ~/Downloads

⚠️ 安全注意事項

• 該服務器需要通過 Claude Desktop 顯式的用戶權限才能進行命令執行。
• 環境變量可以通過配置進行控制。
• 命令執行過程中包含了超時和錯誤處理機制。

🔧 開發

1. 監視更改：

npm run watch

2. 測試更改：

• 修改 src/ 中的源文件。
• 使用 npm run build 重建項目。
• 重新啟動 Claude Desktop 以加載更改。