apollo-mcp-server – Apollo GraphQL MCP Server 集成 Skill

3周前更新 8 0 0 0

apollo-mcp-server 是用于指导 AI Agent 将 Apollo GraphQL 的 MCP Server 接入开发流程的 Skill，适合在查询 GraphQL API、操作 Apollo 生态数据或配置 MCP 工具调用时使用。

查看调研报告在来源平台打开

AI 与 Agent MCP 开发 # Agent # Apollo # Claude Code # GraphQL # MCP

Skill 安装

多 Agent 安装

npx skills add https://github.com/apollographql/skills --skill apollo-mcp-server

使用 npx skills 快速安装，支持将 Skill 添加到多个兼容的 AI Agent。

Skill 调研报告

Skill 详细介绍

apollographql/skills#apollo-mcp-server 是 Apollo GraphQL 官方 skills 仓库中提供的一个 Skill，作用是帮助用户把 Apollo 的 MCP Server 能力接入到 AI Agent 环境中，让 Agent 能够以标准化方式访问 Apollo GraphQL 相关的工具与数据。

需要先说清楚一点：这个 Skill 本身不是一个独立的软件或服务，它属于 Agent Skill 形态，通常以 SKILL.md 加配套资源的形式存在，被 Agent 加载后扩展 Agent 的能力边界。真正对外提供 GraphQL / Apollo 能力的是 Apollo 的 MCP Server，Skill 负责把这套 MCP 能力接入 Agent 的工作流。

核心功能

把 Apollo MCP Server 接入支持 MCP 的 AI Agent。
让 Agent 能够通过 MCP 协议调用 Apollo 侧暴露的工具与数据。
为 GraphQL 相关的开发、查询、Schema 探索等任务提供 Agent 侧的接入路径。
作为官方仓库中的 Skill，结构、命名和说明遵循 Apollo 的官方组织方式。

典型任务

在 Claude Code 等 Agent 中使用 Apollo MCP Server 相关能力。
围绕 GraphQL API、Schema、查询等任务，让 Agent 通过 MCP 工具完成操作。
把 Apollo 的 MCP 工具链纳入日常开发流程。

工作方式

Skill 被 Agent 加载后，Agent 获得关于 Apollo MCP Server 的使用上下文与指引，然后在需要时通过 MCP 协议与 Apollo MCP Server 交互。是否真正能连通、能调用哪些工具，取决于 Apollo MCP Server 自身的配置和暴露的能力，而不是由 Skill 单独决定。

适合的用户

已经在使用 Apollo / GraphQL，希望把相关能力接入 AI Agent 的开发者。
希望用 MCP 统一方式管理 Agent 与后端数据源连接的团队。
正在使用 Claude Code 等支持 MCP 的 Agent，并想扩展 GraphQL 相关能力的人。

不适合的需求

不涉及 Apollo / GraphQL、也不需要 MCP 接入的场景。
希望安装即用、不需要任何 MCP 或 GraphQL 配置的用户。
把 Skill 当作独立软件来运行的需求。

简单说：它是 Apollo 官方为 Agent 生态提供的一个接入入口，负责把 Apollo MCP Server 的能力接到 Agent 上，而不是一个可以单独运行的工具。

Skill 安全评估

总体判断：apollographql/skills#apollo-mcp-server 来自 Apollo 官方仓库，来源可信度较高。它属于 Skill / MCP 接入类内容，本身不包含大范围系统操作，风险主要取决于 MCP Server 侧配置以及 Agent 被授予的权限。

来源可信度

该 Skill 位于 apollographql 官方组织下的 skills 仓库，属于官方一手来源，供应链风险相对较低。仍建议关注仓库更新情况，确认使用的是官方版本，而非第三方镜像或重新发布版本。

网络访问

MCP 接入通常涉及 Agent 与 MCP Server 之间的网络或本地通信。这属于该 Skill 的正常用途，本身不构成异常。需要关注的是连接目标是否是用户自己配置的可信服务。

凭证与配置

如果 Apollo MCP Server 或后续 GraphQL 服务需要 Token、API Key 或授权信息，这些凭证由用户自己在 MCP Server 或 Agent 侧配置。Skill 本身不负责替用户管理这些凭证。凭证泄露风险主要来自配置方式，例如是否把密钥写进了会被提交到代码仓库的文件。

文件与 Shell 权限

Skill 通常不主动读写本地文件或执行 Shell 命令。但如果 Agent 在调用 MCP 工具过程中被授予了文件写入或命令执行权限，风险来自 Agent 与工具的组合行为，而非 Skill 本身。可以按最小权限原则，只开放完成任务所需的能力。

降低风险的建议

只从 Apollo 官方仓库获取该 Skill。
凭证放在安全位置，避免提交到版本库。
只连接自己信任的 MCP Server 地址。
按最小权限原则配置 Agent，不需要时不开自动执行。
生产环境使用前，先在隔离环境中验证接入流程。

没有证据表明该 Skill 存在已知的恶意行为，但也不应把它描述为绝对无风险。是否安全，取决于用户自己的配置和使用方式。

Skill 使用要求

一、Agent / 客户端

该 Skill 与 Claude Code 等支持 MCP 与 Skills 机制的 Agent 适配度较高，可以优先在 Claude Code 中使用。Apollo 官方并未公布完整的第三方 Agent 兼容列表。从 Agent Skill 与 MCP 的工作方式来看，在支持 Skills、自定义 Skill 或 MCP 接入机制的 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等环境中通常也可以尝试，但加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

项目	要求
Agent	Claude Code 优先，其他支持 MCP / Skills 的 Agent 可尝试
MCP 支持	必需，用于接入 Apollo MCP Server
网络	取决于 MCP Server 部署位置，本地或远程均可能
Node.js / Python	是否需要取决于 Apollo MCP Server 自身的安装与运行方式

具体运行时依赖以 Apollo MCP Server 官方说明为准，Skill 本身不额外规定 Node.js 或 Python 版本。

三、权限

网络访问：必需，用于与 MCP Server 通信。
MCP Server 配置权限：必需，用于指定要接入的 Apollo MCP Server。
文件写入：通常可选，仅在实际安装或配置 MCP Server 时需要。
Shell / 命令执行：通常可选，视 Apollo MCP Server 的安装方式而定。

四、账号 / API Key

Skill 本身不要求单独的账号或 API Key。是否需要凭证取决于 Apollo MCP Server 以及后续连接的 GraphQL 服务的配置。如果这些服务需要 Token、API Key 或授权信息，需由用户在 MCP Server 或 Agent 侧自行配置。

最小使用条件

一个支持 Skills 或 MCP 的 Agent（Claude Code 优先）。
可访问的 Apollo MCP Server 实例。
Agent 具备与 MCP Server 通信所需的网络与配置权限。

Skill 安装、使用与卸载教程

一、安装

可以直接复制本页面提供的 Skill 安装指令，粘贴到对应的 Agent 或终端中执行。

如果不确定自己的 Agent 如何安装，可以直接向当前 Agent 提问：

如何安装 apollographql/skills#apollo-mcp-server？

如何在 Claude Code 中安装 apollographql/skills#apollo-mcp-server？

如何在 Codex 中安装 apollographql/skills#apollo-mcp-server？

如何在 Cursor 中安装 apollographql/skills#apollo-mcp-server？

让 Agent 根据自己的 Skill 加载或 MCP 管理机制给出安装指引。如果后续还需要真正运行 Apollo MCP Server，请参考 Apollo 官方关于 MCP Server 的说明来完成服务侧配置，Skill 本身不替代 MCP Server 的部署。

二、安装后如何使用

安装后，当任务涉及 Apollo、GraphQL、Schema 探索或 MCP 工具调用时，Agent 会依据 Skill 提供的上下文来组织操作。用户只要用自然语言描述需求即可，例如：

使用 apollo-mcp-server，帮我通过 MCP 连接我的 Apollo GraphQL 服务，并列出可用的工具。

使用 apollo-mcp-server，帮我查看这个 GraphQL Schema 的查询入口，并说明可以怎么用。

使用 apollo-mcp-server，帮我把这次 GraphQL 查询请求通过 MCP 工具执行一遍，并展示返回结果。

如果 Agent 没有自动触发，可以显式提到 Skill 名称，或者在提示里说明要使用 Apollo 的 MCP 能力。

三、卸载

不同 Agent 的 Skill 安装位置和管理方式可能不同。优先使用对应 Agent 或 Skill 管理器提供的删除方式移除该 Skill。如果没有统一卸载命令，直接询问当前 Agent 更稳妥：

如何卸载 apollographql/skills#apollo-mcp-server？

如果同时配置了 Apollo MCP Server，请按 Apollo 官方说明单独处理 MCP Server 的停止或清理，Skill 的移除不会自动清理 MCP Server 侧配置。

常见问题

1. Skill 安装后，Agent 好像没有识别到，怎么办？

先确认 Skill 是否被放到了当前 Agent 实际加载 Skill 的位置，然后重启或重新加载 Agent 会话。可以再直接询问当前 Agent 是否已经识别到 apollographql/skills#apollo-mcp-server。如果 Agent 支持显式列出已加载 Skill，用列表功能确认一次最直接。

2. 安装了 Skill，是不是就不用配置 MCP Server 了？

不是。Skill 负责把 Apollo MCP Server 接入 Agent 的上下文，真正提供工具与数据的是 MCP Server 一侧。要能实际调用，还需要有一个可访问的 Apollo MCP Server 实例并完成相应配置。

3. 可以同时安装到多个 Agent 吗？

一般来说可以。Skill 本身是可以被多个 Agent 环境分别加载的内容。不同 Agent 的安装位置和管理方式不同，需要分别在各自环境中安装，并各自确认 MCP Server 的连接配置。

4. Skill 更新后需要重新安装吗？

取决于 Agent 的 Skill 管理方式。有的 Agent 支持自动或手动更新已安装 Skill，有的需要重新拉取。以对应 Agent 的说明为准。可以询问当前 Agent 如何更新 apollographql/skills#apollo-mcp-server。

5. 中国大陆使用是否有额外网络要求？

该 Skill 涉及 Apollo GraphQL 生态与 MCP Server 通信。如果 MCP Server 部署在境外，或者需要访问境外服务，中国大陆网络环境下可能受到影响。请按实际部署位置和网络情况评估。如果 MCP Server 部署在本地或国内可访问的环境，通常不涉及额外要求。

6. 这个 Skill 适合用在生产环境吗？

是否适合生产环境，取决于 Apollo MCP Server 自身是否达到生产可用标准，以及 Agent 被授予的权限范围。Skill 只是接入层。建议先在非生产环境验证接入流程、权限边界和凭证管理方式，再考虑用于生产。

7. 感觉和普通的 GraphQL 调用有什么区别？

普通 GraphQL 调用通常需要你自己在代码或命令行里组织请求。这个 Skill 的意义在于把 Apollo MCP Server 的能力接入 Agent，让 Agent 能够以 MCP 工具的方式调用相关能力，从而在对话式工作流里完成 GraphQL 相关任务。它不改变 GraphQL 本身，改变的是 Agent 使用 GraphQL 能力的路径。

Skill 更新日志

版本列表

v1.2.10 最新 2026-09-24

## 变更内容 * chore(deps)：将依赖 prettier 更新至 v3.9.8，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/79 * docs：将 connectors 技能指向最新的 Federation 和 Connectors LTS，由 @mabuyo 提交于 https://github.com/apollographql/skills/pull/80 ## 新贡献者 * @mabuyo 在 https://github.com/apollographql/skills/pull/80 中做出了首次贡献 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.9...v1.2.10

v1.2.9 2026-07-29

## 变更内容 * feat：添加 authz、safelisting、config-as-code，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/69 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.8...v1.2.9

v1.2.8 2026-07-28

## 变更内容 * chore：将 CLAUDE.md 符号链接到 AGENTS.md 并记录版本升级，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/78 * docs：将 rust-best-practices 技能与上游手册同步，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/76 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.7...v1.2.8

v1.2.7 2026-07-28

## 变更内容 * chore(deps)：将依赖 prettier 更新至 v3.9.4，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/73 * chore(deps)：将依赖 prettier 更新至 v3.9.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/74 * chore(deps)：将依赖 prettier 更新至 v3.9.6，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/75 * docs：澄清 federation 链接版本是下限，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/77 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.6...v1.2.7

v1.2.6 2026-07-03

## 变更内容 * chore(deps)：将依赖 prettier 更新至 v3.8.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/70 * chore(deps)：将依赖 prettier 更新至 v3.9.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/71 * 修复 list-apollo-kotlin-versions.sh 的链接，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/72 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.5...v1.2.6

v1.2.5 2026-06-04

## 变更内容 * docs：记录 rover schema --coord 形式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/68 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.4...v1.2.5

v1.2.4 2026-06-03

## 变更内容 * Rover schema 探索，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/67 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.3...v1.2.4

v1.2.3 2026-05-25

## 变更内容 * 更新 Apollo Kotlin 技能以包含迁移指南，由 @martinbonnin 提交于 https://github.com/apollographql/skills/pull/66 ## 新贡献者 * @martinbonnin 在 https://github.com/apollographql/skills/pull/66 中做出了首次贡献 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.2...v1.2.3

v1.2.2 2026-05-04

## 变更内容 * docs：将 gh 技能固定切换为 --pin 标志，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/62 * docs：澄清 gh cli 注释与多技能安装匹配，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/63 * docs：修复无效的 SDL 和不匹配的复杂度库，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/64 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.1...v1.2.2

v1.2.1 2026-04-28

## 变更内容 * feat：将 gh skill cli 与自动发布集成，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/60 * fix(apollo-ios)：记录不受信任内容的威胁模型，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/61 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.2.0...v1.2.1

v1.2.0 2026-04-28

## 变更内容 * ci：强制升级插件版本，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/59 * 添加 apollo-ios 技能，由 @AnthonyMDev 提交于 https://github.com/apollographql/skills/pull/58 ## 新贡献者 * @AnthonyMDev 在 https://github.com/apollographql/skills/pull/58 中做出了首次贡献 **完整变更日志**：https://github.com/apollographql/skills/compare/v1.0.0...v1.2.0

v1.0.0 2026-04-28

## 变更内容 * 处理 Apollo Client 技能反馈：AC4 模式、TypedDocumentNode、缓存最佳实践，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/2 * 更新 README.md，由 @debergalis 提交于 https://github.com/apollographql/skills/pull/4 * 处理 PR #1 反馈：修复 Apollo Client 4.x 文档问题，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/3 * 为 Next.js、React Router 和 TanStack Start 添加框架特定的 Apollo Client 设置指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/6 * chore：配置 Renovate，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/9 * 使文档语气与 Apollo Voice 指南保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/8 * 添加特定于 Apollo Client 技能的 Copilot 指令，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/12 * 添加 skill-creator 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/10 * 从恢复的文档访问中添加完整的 Apollo Client Suspense hooks 文档，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/11 * 添加强调共置而非复用的 fragments 参考指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/13 * 分离客户端和 SSR 集成指南，将 setup 重命名为 integration，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/16 * 用完整手册章节替换 rust-best-practices 摘要，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/15 * 为 JavaScript/TypeScript 代码示例添加 Prettier 格式化，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/17 * 将 apollo-client 技能与上游提交 7f665110 同步，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/18 * 使 Apollo Server 技能与 Apollo Server 5.x 文档保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/19 * 更新一些导入，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/20 * 将 `skill-creator` 技能添加到活跃的 Copilot Skills，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/23 * 修复 apollo-mcp-server 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/21 * 为 PR 添加 skills-ref 验证工作流，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/25 * 添加 Apollo Kotlin 技能，由 @BoD 提交于 https://github.com/apollographql/skills/pull/26 * Apollo Kotlin 技能：添加脚本以获取最新版本，由 @BoD 提交于 https://github.com/apollographql/skills/pull/28 * 标准化技能版本格式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/29 * 更新指令信息，由 @dariuszkuc 提交于 https://github.com/apollographql/skills/pull/32 * chore(deps)：将依赖 prettier 固定为 3.8.1，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/33 * 修复拼写错误，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/31 * 添加 apollo-federation 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/5 * feat：为联邦 GraphQL 超级图添加 apollo-router 技能，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/22 * 添加 Claude Code Plugin 支持，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/34 * 修复 apollo-mcp-server 技能配置示例中不正确的字段名，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/35 * feat(apollo-router)：使交接和快速开始以技能为先，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/36 * feat(skill)：apollo-router-plugin-creator，由 @samuelAndalon 提交于 https://github.com/apollographql/skills/pull/30 * 从允许的工具中移除 curl，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/38 * 更新 apollo-mcp-server 技能以确保准确性，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/39 * fix：更正 apollo-mcp-server 参考中的 CORS 配置选项，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/40 * fix：修复损坏的链接和语法/拼写问题，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/41 * ci：添加 AI 驱动的技能同步工作流，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/42 * refactor：直接将技能与产品源进行比较，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/43 * ci：在技能同步中包含新功能覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/44 * fix：对分诊结果使用 structured_output，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/45 * fix：将多操作示例拆分为每个文件一个操作，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/46 * 用 Claude CLI 替换 claude-code-action，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/47 * feat：添加 GraphQL LSP 服务器配置，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/49 * chore(deps)：将依赖 prettier 更新至 v3.8.2，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/50 * chore(deps)：将依赖 prettier 更新至 v3.8.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/51 * feat：从 apollo-client 仓库同步 apollo-client 技能，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/52 * fix(apollo-router)：围绕 Cache-Control 头重构响应缓存，由 @abernix 提交于 https://github.com/apollographql/skills/pull/53 * docs(apollo-router)：扩展可观测性和 Redis 部署指南，由 @abernix 提交于 https://github.com/apollographql/skills/pull/54 * sync：从 apollo-client@47c63b9795770ad581f77d892932f97b1cb2eb87 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/55 * 为 apollo-router 技能添加响应缓存覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/37 * sync：从 apollo-client@de252731ffdc61026b01dd4be9f8d11a98daf43e 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/57 ## 新贡献者 * @Copilot 在 https://github.com/apollographql/skills/pull/2 中做出了首次贡献 * @debergalis 在 https://github.com/apollographql/skills/pull/4 中做出了首次贡献 * @svc-secops 在 https://github.com/apollographql/skills/pull/9 中做出了首次贡献 * @phryneas 在 https://github.com/apollographql/skills/pull/12 中做出了首次贡献 * @DaleSeo 在 https://github.com/apollographql/skills/pull/10 中做出了首次贡献 * @BoD 在 https://github.com/apollographql/skills/pull/26 中做出了首次贡献 * @dariuszkuc 在 https://github.com/apollographql/skills/pull/32 中做出了首次贡献 * @jvanderwee 在 https://github.com/apollographql/skills/pull/31 中做出了首次贡献 * @gocamille 在 https://github.com/apollographql/skills/pull/22 中做出了首次贡献 * @samuelAndalon 在 https://github.com/apollographql/skills/pull/30 中做出了首次贡献 * @abernix 在 https://github.com/apollographql/skills/pull/53 中做出了首次贡献 **完整变更日志**：https://github.com/apollographql/skills/commits/v1.0.0

暂无评论

暂无评论...