SkyDeck AI 助手应用

了解 SkyDeck AI Helper 桌面应用程序，该应用程序管理 GenStudio Workspace 的模型上下文协议 (MCP) 服务器。

SkyDeck AI Helper 是一款强大的桌面应用程序，作为 MCP 服务器的管理中心。它提供了一个统一的界面，用于发现、安装和管理您本地计算机上的 AI 工具。该应用程序弥合了像 GenStudio Workspace 这样的 AI 应用与本地工具之间的差距，增强了 AI 在处理您的数据时的能力，同时保持隐私和安全。

可以将其视为 AI 应用的“工具管理器” - 它允许您的 AI 助手以安全、受控的方式访问您计算机上的特定功能。

SkyDeck AI Helper 应用

什么是模型上下文协议 (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. 启动应用：从您的应用程序文件夹打开它，或简单地切换开关为 ON

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 服务器支持： 增加了与最新模型上下文协议服务器的兼容性

• 用户界面改进： 精炼了导航和服务器卡片

• 性能优化： 降低了内存使用和更快的服务器切换

• 改进的错误处理： 对连接问题提供更好的反馈

• 更新机制： 更顺畅的应用程序更新

• 文档： 增强了应用内帮助资源

常见问题解答

常见问题

问：SkyDeck AI Helper 用于什么？ 答：它管理您计算机上的 MCP 服务器，使 AI 应用程序（如 SkyDeck GenStudio）能够安全访问增强其功能的工具和数据。

问：SkyDeck AI Helper 是免费使用的吗？ 答：是的，SkyDeck AI Helper 完全免费使用。

问：该应用程序需要一直运行吗？ 答：为了让 AI 应用程序访问 MCP 服务器，是的。不过，它在后台高效运行，资源使用极少。

问：我可以将 SkyDeck AI Helper 与其他 AI 应用程序一起使用吗？ 答：目前，这个助手应用程序仅支持 SkyDeck GenStudio。不过，我们确实计划增加对更多 AI 应用程序的支持，例如 Claude 桌面应用程序。

问：SkyDeck AI Helper 会提供 Windows 或 Linux 版本吗？ 答：Windows 支持目前正在开发中，Linux 支持正在考虑中。请关注我们的官方渠道，以获取有关平台可用性的公告。

技术问题

问：这个应用程序会使用我多少系统资源？ 答：SkyDeck AI Helper 设计为轻量级，但资源使用量取决于活动服务器的数量和类型。

问：应用程序会收集我的数据吗？ 答：不会。该应用程序仅促进 AI 应用程序与本地 MCP 服务器之间的通信。它不会收集或传输用户数据。

问：我可以在没有互联网访问的情况下运行应用程序吗？ 答：一旦安装了服务器，许多服务器可以在没有互联网访问的情况下运行，尽管某些服务器可能需要在线服务才能完全操作。

问：我需要安装额外的依赖项吗？ 答：是的。大多数服务器需要 Python 或 Node.js。如果缺少这些，应用程序会指导您进行安装。

问：我怎么知道我需要哪些服务器？ 答：从与您的用例匹配的服务器开始。对于开发，推荐使用 SkyDeck AI Code。对于专业编码任务，Claude Code 很有用。您可以根据需要随时安装额外的服务器。

问：我可以开发自己的 MCP 服务器吗？ 答：可以。MCP 协议是开放的，开发人员可以创建自定义服务器。请查看 https://modelcontextprotocol.io 上的 MCP 文档以获取开发指南。