SkyDeck AI 助手應用程式

了解 SkyDeck AI Helper 桌面應用程式，該應用程式管理 GenStudio Workspace 的模型上下文協議 (MCP) 伺服器。

SkyDeck AI Helper 是一款強大的桌面應用程式，作為 MCP 伺服器的管理中心。它提供了一個統一的介面，用於發現、安裝和管理您本地機器上的 AI 工具。該應用程式彌合了像 GenStudio Workspace 這樣的 AI 應用程式與本地工具之間的差距，增強了 AI 在處理您的數據時的能力，同時保持隱私和安全。

把它想像成一個 AI 應用程式的「工具管理器」——它允許您的 AI 助手以安全、受控的方式訪問您計算機上的特定功能。

SkyDeck AI Helper App

什麼是模型上下文協議 (MCP)？

模型上下文協議 (MCP) 是一個開放標準，定義了 AI 應用如何連接到不同的工具和數據來源（類似於 USB-C 提供了一種標準化的方式來將您的設備連接到各種外圍設備）。

MCP 的主要組件

• MCP 客戶端：使用 MCP 訪問工具和數據的 AI 應用程序（如 Claude Desktop、SkyDeck GenStudio）

• MCP 伺服器：通過協議公開特定功能（工具）的程序

• MCP 工具：伺服器提供的執行特定任務的單個功能

SkyDeck AI Helper 管理提供這些工具給您的 AI 應用程序的伺服器。

優勢

• 集中式 MCP 管理： 從單一直觀介面管理所有的 MCP 伺服器

• 增強的 AI 能力： 使用本地工具和數據來源擴展 AI 應用

• 安全的工具執行： 基於權限的安全性以保護敏感工具操作

• 實時伺服器狀態： 監控所有連接伺服器的健康狀況和可用性

• 標準化的 AI 整合： 使用模型上下文協議以確保一致的 AI 互動

• 背景操作： 在您使用其他應用程式時，能有效地在系統托盤中運行

支援的平台

目前，SkyDeck AI Helper 可用於：

• macOS：Intel 和 Apple Silicon (M1/M2/M3) 處理器

未來計劃支援（尚未可用）：

• Windows（開發中）

• Linux（考慮中）

前置條件

在安裝 SkyDeck AI Helper 之前，請確保您擁有：

1. 作業系統：macOS 10.15 (Catalina) 或更新版本

2. uv：Python 套件管理器（許多 MCP 伺服器所需）

   • 我們建議通過 Homebrew 安裝 uv：brew install uv

3. Node.js：Node 基礎伺服器所需（版本 14.x 或更新版本）

   • 我們建議通過 Homebrew 安裝 Node.js：brew install node

快速入門指南

1. 下載與安裝：從您的 GenStudio 工作區下載並安裝 SkyDeck AI Helper 應用程式

2. 啟動應用程式：從您的應用程式資料夾中打開，或簡單地將開關切換為開啟

3. 安裝伺服器：前往「MCP 伺服器」標籤，選擇一個伺服器，然後點擊「安裝」

4. 連接到 AI：您的 SkyDeck GenStudio 將自動檢測您已安裝的伺服器

5. 開始使用工具：您的 AI 現在可以使用已安裝伺服器提供的功能

開始使用

當您首次啟動 SkyDeck AI Helper 時，您將看到一個簡單的介面，左側有一個導航欄提供不同的部分：

1. MCP 伺服器：從 mcp-get.com 和 smithery.ai 瀏覽和安裝伺服器

2. 已安裝：管理已安裝在您系統上的伺服器

3. 伺服器日誌：查看所有連接伺服器的活動日誌

4. 設定：配置應用程式偏好設定

該應用程式將在系統托盤中運行，允許您在使用其他應用程式時隨時訪問它。

管理 MCP 伺服器

尋找和安裝伺服器

1. 瀏覽到 "MCP 伺服器" 標籤

2. 瀏覽可用的伺服器或使用搜索功能來查找特定功能

3. 點擊伺服器卡片以閱讀詳細信息

4. 點擊 "安裝" 將伺服器添加到您的系統

5. 安裝進度將顯示

6. 完成後，伺服器將自動啟動

管理已安裝的伺服器

在「已安裝」標籤中，您可以：

• 查看狀態：查看哪些伺服器正在運行、停止或出現錯誤

• 啟動/停止伺服器：根據需要切換個別伺服器的開關

• 配置伺服器：設置環境變量和工作目錄

• 查看伺服器詳細資訊：查看所有可用工具和伺服器信息

• 卸載伺服器：移除您不再需要的伺服器

伺服器配置

許多伺服器需要特定的配置才能正常運作：

1. 環境變數：

   • 點擊伺服器頁面上的「環境變數」按鈕

   • 添加伺服器所需的鍵值對

   • 常見的例子包括 API 金鑰或配置選項

1. 工作目錄：

   • 一些伺服器（特別是與文件相關的伺服器）需要一個工作目錄

   • 通過點擊伺服器並訪問目錄設置來設置此目錄

   • 這控制伺服器可以訪問哪些文件

使用工具

每個 MCP 伺服器提供一組 AI 應用程式可以使用的「工具」。這些工具代表特定的功能，例如訪問文件、搜索代碼或與服務互動。

探索可用工具

1. 在「已安裝」標籤中，點擊一個伺服器以訪問其詳細信息

2. 您將看到可用工具的網格

3. 每個工具卡片顯示：

   • 工具名稱：識別能力

   • 描述：解釋工具的功能

   • 參數：工具使用時所需的信息

工具安全性與權限

SkyDeck AI Helper 為工具執行提供了一層安全保障：

• 權限請求：當 AI 應用首次嘗試使用工具時，系統會提示您授予權限

• 信任設置：對於每個工具，您可以切換「始終允許」開關以授予永久權限

• 審計記錄：所有工具使用情況都會記錄在伺服器日誌中

預設伺服器

SkyDeck AI Helper 內建支援這些主要伺服器：

SkyDeck AI 代碼

預設自動安裝，此伺服器提供全面的 AI 驅動開發工作流程工具：

• 檔案操作（讀取、寫入、管理檔案）

• 代碼分析和搜索功能

• 多語言代碼執行

• 網頁內容檢索

• 系統資訊訪問

• 等等

Claude Code

一個可選的 MCP 伺服器，可增強 Claude 的編碼能力：

• 專業的編碼協助

• 檔案分析工具

• 增強的 AI 編碼工作流程

• 必須通過介面單獨安裝

自動更新

SkyDeck AI Helper 會自動檢查更新，並在有可用更新時通知您：

1. 當檢測到新版本時，會顯示更新通知

2. 點擊「立即更新」以開始過程

3. 更新在背景中開始

4. 完成後，應用程序將關閉並重新啟動。

安全性與隱私架構

SkyDeck AI Helper 的設計以安全性和隱私為核心原則：

安全特性

1. 過程隔離：每個伺服器在其自己的過程空間中運行以進行隔離

2. 權限模型：兩層方法：

   • 標記為「始終允許」的工具無需提示即可執行

   • 否則，它們將需要用戶的明確許可

3. 本地執行：所有工具在您的機器上本地運行

隱私考量

1. 不收集數據：該應用程序不收集使用數據

2. 無雲端依賴：伺服器完全在您的本地機器上運行

3. 權限透明：清楚了解正在使用的工具

4. 訪問控制：AI 應用程序只能訪問您明確允許的內容

伺服器管理最佳實踐

要充分利用 SkyDeck AI Helper：

1. 從基本伺服器開始：先從幾個關鍵伺服器開始，而不是安裝所有東西

2. 管理資源：停止您不在使用的伺服器以節省系統資源

3. 仔細檢查權限：對於您標記為「始終允許」的工具要謹慎選擇

4. 定期檢查日誌：查看伺服器日誌標籤以監控工具使用情況

5. 保持依賴項更新：確保 Python 和 Node.js 保持最新

6. 使用特定工作目錄：為基於文件的伺服器設置適當的工作目錄以限制範圍

故障排除

伺服器連接問題

• 問題：伺服器顯示「無法連接」

  • 解決方案：

    • 點擊「重試」，看看是否能解決問題

    • 如果不行，打開伺服器查看為什麼無法連接

    

    • 檢查伺服器是否需要任何環境變數

    • 檢查伺服器規格以查看是否需要其他任何東西

    
• 問題：伺服器安裝成功但工具不可見

  • 解決方案：

    • 驗證伺服器在已安裝標籤中是否正確啟動

    • 嘗試停止並重新啟動伺服器

性能問題

• 問題：應用程序變得緩慢

  • 解決方案：

    • 減少活動伺服器的數量

    • 重新啟動應用程序

    • 在活動監視器中檢查系統資源

發布說明

版本 1.1.4 (2025 年 4 月)

功能與改進

• 增強的伺服器管理： 改進了伺服器狀態和連接的處理

• 托盤圖示增強： 提升了系統托盤中的可見性和功能

• 新增 MCP 伺服器支援： 增加了對最新模型上下文協議伺服器的相容性

• 使用者介面改進： 精煉了導航和伺服器卡片

• 性能優化： 減少了記憶體使用量並加快了伺服器切換速度

• 改進的錯誤處理： 提供了更好的連接問題反饋

• 更新機制： 更流暢的應用程式更新

• 文件： 增強了應用內幫助資源

常見問題

一般問題

Q: SkyDeck AI Helper 用於什麼？ A: 它管理您計算機上的 MCP 伺服器，使 AI 應用程序（如 SkyDeck GenStudio）能夠安全地訪問增強其功能的工具和數據。

Q: SkyDeck AI Helper 是免費使用的嗎？ A: 是的，SkyDeck AI Helper 完全免費使用。

Q: 應用程序需要一直運行嗎？ A: 是的，AI 應用程序需要訪問 MCP 伺服器。不過，它在背景中高效運行，資源使用量極少。

Q: 我可以將 SkyDeck AI Helper 與其他 AI 應用程序一起使用嗎？ A: 目前，這個輔助應用程序僅支持 SkyDeck GenStudio。不過，我們計劃增加對更多 AI 應用程序的支持，例如 Claude 桌面應用程序。

Q: SkyDeck AI Helper 會提供 Windows 或 Linux 版本嗎？ A: Windows 支持目前正在開發中，Linux 支持正在考慮中。請關注我們的官方渠道以獲取有關平台可用性的公告。

技術問題

Q: 應用程式會使用我多少系統資源？ A: SkyDeck AI Helper 設計為輕量級，但資源使用量取決於活動伺服器的數量和類型。

Q: 應用程式會收集我的數據嗎？ A: 不會。該應用程式僅促進 AI 應用程式與本地 MCP 伺服器之間的通信。它不會收集或傳輸用戶數據。

Q: 我可以在沒有網路連接的情況下運行應用程式嗎？ A: 一旦伺服器安裝完成，許多伺服器可以在沒有網路連接的情況下運行，儘管某些伺服器可能需要在線服務才能完全運作。

Q: 我需要安裝額外的依賴項嗎？ A: 是的。大多數伺服器需要 Python 或 Node.js。如果缺少這些，應用程式會指導您進行安裝。

Q: 我怎麼知道我需要哪些伺服器？ A: 從符合您用例的伺服器開始。對於開發，建議使用 SkyDeck AI Code。對於專門的編碼任務，Claude Code 很有用。您隨時可以根據需要安裝額外的伺服器。

Q: 我可以開發自己的 MCP 伺服器嗎？ A: 可以。MCP 協議是開放的，開發者可以創建自定義伺服器。請查看 https://modelcontextprotocol.io 的 MCP 文檔以獲取開發指南。