Resource Guru MCP

Resource Guru + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Resource Guru API 的 MCP 服务。与 Resource Guru Limited 无关联，也未获得其认可或赞助。

_{完整 Skill 页面 - 安装、使用效果、安全模型。}

通过 AI Agent 操作 Resource Guru。可与您已在使用的 AI 配合使用——ChatGPT（Plus/Pro+，此连接器重新发布前暂不可用；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot——也可通过远程方式使用 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（此连接器重新发布前）。 请勿运行 HTTP 模式 （--transport http），即使是在 localhost 上也不行。此版本没有密码， 会监听所有网络接口，并且早于浏览器重绑定防护机制，因此您打开的网页 可以访问它。MCP 工具也可以使用您的凭据进行更改。请使用默认的 stdio 传输。如果您为 远程 Agent 设置了隧道，请将其关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（可自行安装，现已可用）：

您的 AI Agent	如何安装 Resource Guru Skill
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 resourceguru-mcp（无需编辑 JSON）。
ChatGPT（付费计划）	此连接器重新发布前暂不可用：ChatGPT 需要其 HTTP 模式，而此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，将 resourceguru-mcp 添加到 mcp.json 的 servers 键下，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务，这意味着必须使用此连接器的 HTTP 模式；该模式在连接器重新发布前暂停使用：此版本的该模式无需密码，会监听所有网络接口，并且您打开的网页可以访问它。请参阅 mcp-install.md 中的安全提示。

也适用于 Microsoft 和 Google 技术栈

安装量很大，但需要坦诚提醒：这些属于远程／企业方案，而不是你刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直到重新打包此连接器：Copilot Studio 需要使用 HTTP 模式，而在此版本中，该模式不需要密码、会监听所有网络接口，并且可以通过你打开的网页访问。请参阅 mcp-install.md 中的安全说明。
Google Gemini	Gemini CLI 是本地的，与 Claude Code 相同。Gemini 应用是远程的，需要使用与 ChatGPT 相同的暂停 HTTP 模式。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（也涵盖在内）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，也支持 MCP——请参阅下方的安装章节。通过 MCP 也支持 Cursor、Windsurf、Cline、Continue.dev 和 Zed。各工具的完整接入说明：docs/which-agent.md。

要使用多个 Agent？ 使用一条命令即可安装到所有 51+ 个受支持的 Agent：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后为 CLI/MCP 二进制文件运行各 Skill 的安装程序）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式——一键安装 .mcpb

Claude Desktop 安装包： .mcpb 可在 macOS（Intel 和 Apple Silicon）、Windows x64 和 Linux x64 上启动。每个工具都会调用配套的 resourceguru-cli。从 2026-09-18 起发布的版本会在安装包中附带此 CLI；较早的安装包仅包含 MCP 服务，因此，如果你的安装包缺少配套工具，请先运行下方的路径 A 或路径 B 安装程序（或将 RESOURCEGURU_CLI_PATH 设置为现有二进制文件的路径）。详情： #331。

下载 Resource Guru MCP（.mcpb）——然后打开 Claude Desktop > Settings > Extensions 并选择该文件。一键完成，无需 JSON，也无需命令行。（在发布页面查看所有 Resource Guru 版本。）

更喜欢使用 Claude Code 插件？添加一次市场，然后安装即可——立即生效，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install resourceguru@msp-skills

路径 A——向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装 Servosity/msp-skills 的 Resource Guru Skill 和 MCP 服务。如果此工作区使用 POSIX shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.ps1 | iex。然后按照 README 进行身份验证，并运行 resourceguru-cli --help 进行探索。

任何可以运行 shell 的 Agent 都可以使用同一条提示词。

路径 B——自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.sh)

安装程序会将 resourceguru-cli（CLI）和 resourceguru-mcp（MCP 服务）都安装到你的用户 bin 路径中。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 找到 Skill。

验证：

resourceguru-cli --version

升级到最新版本

安装程序始终会获取当前版本——重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/resourceguru/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（见本节顶部），然后在 Settings > Extensions 中重新选择它。Claude Code 插件用户：/plugin update resourceguru@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

安装程序运行后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的接入方式——每个 Agent 都有一个章节，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的接入路径。Claude Desktop 的 Settings > Extensions 面板是最简单的方式；对于偏好编辑 JSON 的用户，MCP 配置块已记录在 mcp-install.md 中。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/resourceguru --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/resourceguru --force

Hermes 原生支持 MCP，因此也可以直接使用 resourceguru-mcp 服务——安装路径相同，环境变量也相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/resourceguru 安装 resourceguru 技能。该技能说明如何通过 openclaw: frontmatter 块安装所需的 CLI（resourceguru-cli）。

OpenClaw 尚未普遍开放；frontmatter 接入配置已预先提供，OpenClaw 一发布便会启用。

身份验证

Resource Guru 使用 HTTP Basic 身份验证——需要你的账户邮箱和密码：

RESOURCEGURU_EMAIL=<value> RESOURCEGURU_PASSWORD=<value> resourceguru-cli doctor

运行任何会触及数据的操作前，doctor 会确认凭据是否有效。即使凭据被拒绝，它也会以退出码 0 结束，因此脚本应添加 --fail-on error。各 Agent 的完整接入配置见 mcp-install.md。

此技能的功能

团队经常提出的问题	命令
本月整个团队中谁的工作安排超负荷？	resourceguru-cli overbooked --start 2026-06-01 --end 2026-06-30 --agent
每个人每天的利用率是多少？	resourceguru-cli utilization --start 2026-06-01 --end 2026-06-30 --heatmap --agent
下周谁有余力承接新工作？	resourceguru-cli bench --start 2026-06-08 --end 2026-06-14 --threshold 50 --agent
下个月还剩多少可预订容量？	resourceguru-cli capacity --start 2026-07-01 --end 2026-07-31 --agent
上周的日程有哪些变更？	resourceguru-cli since 7d --agent
团队的工作量如何分布？	resourceguru-cli load --json
在整个日程中查找预订、客户或项目	resourceguru-cli search "website redesign"

运行一次 resourceguru-cli sync，即可填充本地镜像；之后，上述分析命令便可离线读取数据。

完整命令参考：guide.md。关于 AI Agent 操作规范（--agent、--dry-run、何时应在修改数据前确认），请参阅 AGENTS.md。

与众不同之处

大多数 Resource Guru 集成和 MCP 服务都会针对每个问题代理一次实时 API 调用。查询一条记录时，这样做没问题。但如果要查询“本季度每一天每个资源的已预订与可用容量利用率”，数据规模一大，这种方式就会失效。

此技能会将 Resource Guru 同步到带有全文搜索功能的本地 SQLite 镜像中。汇总类问题只需进行一次本地计算：响应迅速、可离线使用，而且 AI 看到的是答案，而不是原始数据。utilization、overbooked 和 capacity 等组合命令会将预订与各资源的每日可用时间关联起来，完成逐日计算。无状态 API 包装器无法做到这一点，因为 API 虽然提供逐日预订明细，却不会替你汇总。

解决的痛点

在 Capterra 上经过验证的 Resource Guru 评审者表示，报告和高级分析“感觉很有限”，而且他们必须“将报告下载为数据透视表”才能获得所需的细分数据。预订冲突警告会在写入时一次捕捉一项超额分配，但没有统一的全资源视图来查看某个时间段内所有超出容量的资源日期——因此，容量规划变成了电子表格工作。

此技能通过同步镜像弥补了这一不足：

• resourceguru-cli utilization --start <date> --end <date> --heatmap --agent - 显示每天每项资源的已预订量与可用量，而不是时间范围平均值。
• resourceguru-cli overbooked --start <date> --end <date> --agent - 显示整个资源池中所有超出容量的资源日期。
• resourceguru-cli bench --start <date> --end <date> --threshold 50 --agent - 查看哪些资源利用不足、可承接新工作。
• resourceguru-cli capacity --start <date> --end <date> --agent - 在承接项目之前，查看剩余可预订分钟数。
• resourceguru-cli since 7d --agent - 查看自上次查看以来日程发生了哪些变化。

更详细的介绍请参见 pain-point.md。

常见问题

这适用于 ChatGPT 吗？

此版本暂不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 目前尚未开放 Developer Mode）只能通过 HTTPS 连接远程 MCP 服务，这意味着需要以 HTTP 模式运行 Resource Guru MCP 服务。在此版本中，HTTP 模式不要求密码，会监听所有网络接口，并且可被你打开的网页访问，因此在重新发布连接器之前，请勿运行它或将其放在隧道之后；mcp-install.md 中的安全说明解释了原因。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。跨工具安装命令请参见上方的对照表，以及 docs/which-agent.md 中的深入说明。

我需要懂编程吗？

不需要。推荐的安装方式是向 Claude Code 或 Codex 粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是在每种操作系统上使用一行安装命令（bash 或 PowerShell）。这两种方式都无需编写代码。你只需输入一次 Resource Guru 凭据。

我的 Resource Guru 数据安全吗？

你的数据会保留在自己的机器上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将其打包进此代码库，也不会将其传输到任何地方。

这会触及 Resource Guru API 的速率限制吗？

不会。首次运行 sync 后，utilization、overbooked、bench、capacity 和 search 都会读取本地 SQLite 镜像，不会调用 API。只有同步或执行实时读取时才会访问 API，CLI 会遵守可配置的 --rate-limit。

我必须是 Resource Guru 管理员吗？

不需要。你需要一个能够读取日程的帐户，并使用帐户邮箱和密码通过 HTTP Basic 进行身份验证。只读分析不需要写入或管理员权限——请根据实际用途限定凭据权限。

这会取代 Resource Guru 网页应用吗？

不会。它用于报告和分析，不能用来编辑日程。写入操作通过网页应用使用的同一 API 执行，因此请在 Resource Guru 中确认每次修改。它的独特价值在于提供门户中未展示的逐日、全资源池利用情况。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为所使用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 服务提供商收取，而不是由我们收取。

安全模型

层级	示例	建议的 Agent 策略
读取	utilization、overbooked、bench、capacity、since、load、search、accounts list、任意 get	允许
写入（常规）	bookings create、bookings update、clients create、projects update、activity-types create	使用 --dry-run 预览，然后执行经审核的写入操作
破坏性操作／配置	bookings delete、clients delete、resources delete、calendars delete、webhooks delete	仅允许人工介入

最有力的控制措施是授予 Resource Guru 凭据的权限范围——CLI 只能执行凭据被允许执行的操作。完整详情（包括如何限制权限）请参见 governance.md。

状态

Beta 版。已根据 Resource Guru API 功能范围进行验证，目前正在每周 Build Sessions 中，与使用自己的生产租户运行该工具的 MSP 一起进行验证。请在 compoundingteams.com/build-sessions 报名参加。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40 多种 Agent）。兼容 MCP——可与任何支持 MCP 的 Agent 配合使用，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。上次更新：2026-06-30。