agc-connect-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGC_SITE | No | Site code: cn (default), de, sg, or ru for China, Germany, Singapore, or Russia. | cn |
| AGC_CLIENT_ID | No | API client ID (alternative to AGC_CLIENT_FILE). | |
| AGC_READ_ONLY | No | Set to 'true' to disable all write operations (upload, submit, reply, non-query requests). | false |
| AGC_TIMEOUT_MS | No | Single request timeout in milliseconds. | 120000 |
| AGC_CLIENT_FILE | No | Path to the API client JSON file (must contain client_id and client_secret). | |
| AGC_CLIENT_SECRET | No | API client secret (alternative to AGC_CLIENT_FILE). | |
| AGC_KNOWLEDGE_MCP | No | Set to 'off' to disable the HarmonyOS knowledge base tools. | on |
| AGC_DOCS_CACHE_DIR | No | Cache directory for Connect API documentation (cached for 7 days). | ~/.cache/agc-connect-mcp/docs |
| AGC_KNOWLEDGE_MCP_URL | No | Custom URL for the knowledge base MCP (defaults to Huawei official address). | |
| AGC_SERVICE_ACCOUNT_FILE | No | Path to the Service Account JSON file downloaded from AppGallery Connect. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| agc_search_apiA | 在内置的 AppGallery Connect Connect API 目录（约 200 个端点、450 篇文档，含数据模型、错误码、附录）中按关键词搜索。关键词可用中文或英文，空格分隔表示同时匹配。找到端点后用 agc_get_api_doc 查看参数，再用专用工具或 agc_request 调用。 |
| agc_get_api_docA | 读取某个 Connect API 文档的完整内容（Markdown，含接口 URL、Header/Query/Body 参数表、响应字段、示例）。正文从华为开发者文档中心实时拉取并在本地缓存 7 天。docId 来自 agc_search_api 的 doc 字段；也可传文档标题（精确）或 docId 片段。 |
| agc_requestA | 以当前凭据调用任意 Connect API 端点（自动添加鉴权头、按站点选择域名）。适用于没有专用工具的接口，如 PMS 商品管理、Provisioning 证书/Profile、Testing 测试版本、Domain、资质审核、协议管理等。调用前请先用 agc_get_api_doc 确认方法、路径和参数。返回 HTTP 状态与原始 JSON。 |
| agc_auth_statusA | 显示已配置的凭据（Service Account / API 客户端）、站点、只读模式，并逐一验证：API 客户端会向华为换取 token；Service Account 会本地签发 JWT 并调用一次查询接口确认可用。 |
| agc_get_app_idA | 根据应用包名（最多 50 个，逗号分隔）查询 AGC 应用 ID（appId）。 |
| agc_list_appsA | 列出当前团队的所有 AGC 项目及每个项目下的应用（appId、名称、包名、设备类型）。（官方的“获取团队列表 / 应用简略信息”接口只对 OAuth 客户端开放，本工具改用项目管理接口实现。） |
| agc_get_app_infoB | 查询应用基本信息、各语言描述、审核意见、分阶段发布信息等。 |
| agc_upload_fileA | 把本地文件（软件包 .app/.apk/.aab/.rpk、图标、截图、视频、PDF、资质 zip 等）上传到 AGC 文件服务器，返回 objectId。得到 objectId 后需调用相应接口（如 agc_update_app_package，或通过 agc_request 调用更新应用文件信息接口）把文件关联到应用。 |
| agc_update_app_packageA | 上传软件包并写入应用当前草稿版本：HarmonyOS 走 PUT /api/publish/v3/app-package-info（返回 packageId），Android 走 PUT /api/publish/v2/app-file-info（fileType=5，返回 pkgVersion）。可以传本地 filePath（自动上传），也可以传已上传的 objectId + fileName。软件包需异步解析，约 2 分钟后再提交发布，可用 agc_get_package_compile_status 查询。 |
| agc_get_package_compile_statusC | 查询软件包解析状态。successStatus：0 正常 / 1 解析中 / 2 失败。 |
| agc_submit_appA | 提交应用审核发布（上架）。调用前应确认应用信息完整、软件包已解析成功。这是对外生效的操作，调用前请与用户确认。HarmonyOS 走 POST /api/publish/v3/app-submit；Android 走 POST /api/publish/v2/app-submit。 |
| agc_list_reviewsA | 查询应用评论列表（时间跨度不超过 6 个月，一次只能查询同一站点内的国家）。需要 API 客户端凭据（评论接口不支持 Service Account）；站点（site）需与所查国家所在站点一致。 |
| agc_get_ratingsA | 查询应用评分汇总（平均分、各星级数量）和评分明细。仅已上架应用有数据；时间跨度不超过 6 个月。需要 API 客户端凭据。 |
| agc_reply_reviewA | 以开发者身份公开回复用户评论（或回复用户的追加回复）。回复会对所有用户可见，调用前请与用户确认回复内容。 |
| agc_get_reportA | 导出运营报表（CSV/Excel），返回文件下载地址（有效期约 5 分钟，需要内容时直接传 downloadTo）；可选下载到本地并预览前若干行。时间跨度一般不超过 180 天。可用报表：
|
| harmonyos_search_docsA | 通过华为官方“鸿蒙开发者知识 MCP”检索最新的 HarmonyOS 官方文档：版本说明、API 参考、开发指南、最佳实践、FAQ、DevEco Studio 指南、UX 设计、应用上架与分发等（与官网准实时同步）。返回匹配的文本片段及文档标识 parent；片段不够时用 harmonyos_get_docs 取全文。Connect API 接口参数请优先用 agc_search_api / agc_get_api_doc。 |
| harmonyos_get_docsA | 按文档标识批量获取 HarmonyOS 官方文档全文（Markdown，一次最多 10 篇）。标识来自 harmonyos_search_docs 结果的 parent 字段。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Most tools target distinct resources and actions, and the agc_/harmonyos_ prefixes clearly separate API catalog docs from HarmonyOS docs. The main ambiguity is agc_request as a generic fallback that conceptually overlaps with all specialized tools, and agc_upload_file vs agc_update_app_package share upload behavior, but descriptions draw clear boundaries.
The vast majority follow a consistent agc_verb_noun pattern, and the two harmonyos_ tools are internally consistent. Minor deviations like agc_auth_status (no verb) and agc_request (not verb_noun) plus the mixed prefixes keep it from a perfect score.
17 tools is slightly above the ideal 3-15 range, but the broad AppGallery Connect domain justifies the count. Each tool covers a meaningful workflow area, and the generic agc_request tool prevents the surface from becoming bloated with dozens of endpoint-specific tools.
The specialized tools cover the core app publishing lifecycle: discovery, auth, package upload, compile status, submission, reviews, ratings, and reports. The generic agc_request tool plus search/get documentation tools ensures any remaining Connect API endpoint can be reached, so there are no obvious dead ends.