---
name: agent-mcp-finder
description: 查找中国服务厂商官方出品的 MCP Server、Agent Skill 和命令行工具（CLI），并告诉用户怎么接入。用户想让 Agent 操作某个国内服务（如高德地图、美团、飞书、支付宝、瑞幸），或问「某某有没有官方 MCP / Skill」「怎么让 Agent 帮我点外卖、打车、查股票、写飞书文档」时使用。
---

# 查找国内官方 Agent 连接器

这个 Skill 读取 Awesome Agent MCP 索引，帮用户找到能完成任务的**官方**接入方式。

## 数据来源

先读 `https://guanmo-ai.github.io/awesome-agent-mcp/llms.txt` 简明索引，再按需求读取其中链接的 `s/<id>.md`，获取该服务的完整配置、接入步骤与官方出处。

需要程序筛选或更多字段时读 `https://guanmo-ai.github.io/awesome-agent-mcp/services.json`；备用数据地址为 `https://raw.githubusercontent.com/guanmo-ai/awesome-agent-mcp/main/data/services.json`。需要一次读取全部接入指引时才读 `https://guanmo-ai.github.io/awesome-agent-mcp/llms-full.txt`。

`services.json` 中每个服务的主要字段：

| 字段 | 含义 |
| :-- | :-- |
| `name` / `summary` | 服务名和一句话能力说明 |
| `category` | 分类 id，对应 `categories` |
| `types` | `mcp`、`skill`、`cli` 中的一个或多个 |
| `url` | 官方入口，接入以它为准 |
| `risk` | `read` 只读查询；`write` 会创建或修改数据；`payment` 可能下单或付款 |
| `access` | 接入门槛，例如 `key`（需 API Key）、`membership`（需会员）、`desktop-app`（需桌面客户端）；空数组表示尚未整理 |
| `evidence` | 官方出处、核验及摘录日期 `checkedAt`、逐字原文 `quote`、页面可否直接读取正文 `agentReadable`；未提供摘录时不能推断 |
| `status` | `verified` 已确认为官方出品；`unverified` 尚未逐条确认 |
| `install.mcp` | 现成的 MCP 配置：`transport`（`http` / `sse` / `stdio`）、`url` 或 `command` 加 `args` |
| `setup` | 接入前准备 `requirements`、带官方入口的 `steps`、验证方法 `verify` 与核对日期；验证方法并非本项目实测结果 |
| `install.cli` / `install.skill` | 命令行工具的安装命令；Skill 文件的地址 |

## 步骤

1. 把用户的需求拆成要用的服务或能力，例如「点咖啡」对应瑞幸、麦当劳，「查路线」对应地图类服务。
2. 读取数据，排除 `status: rejected`，按 `name`、`summary` 和分类匹配。优先选 `status: verified` 的条目，其次是 `unverified`。回到厂商文档核对实际能力、适用对象、账号与费用门槛，区分商家接口和面向个人的服务。官方身份核验不代表已实测接入。官方页面读不到时，以索引中的官方原文摘录为依据，并告诉我这一点。没有对应摘录的内容仍须核实，不要猜测。
3. 有 `setup` 时先读接入前准备和步骤，按用户身份选择一条可用路径；如 CLI 已能完成任务，不要求同时安装 MCP 和 Skill。指引里未知的门槛要如实说明。对每个候选，告诉用户：
   - 服务名、能做什么、类型（MCP / Skill / CLI）
   - 接入门槛（`access` 和 `setup.requirements`）；access 为空但有准备说明时引用说明，两者均缺失才说「门槛未整理，请看官方文档」
   - 官方链接 `url`
   - 有 `install.mcp` 时，给出用户所用客户端的配置。远程服务（http / sse）示例：Claude Code 用 `claude mcp add --transport <transport> <id> "<url>"`；JSON 用 `{"mcpServers": {"<id>": {"type": "<transport>", "url": "<url>"}}}`
   - 有 `install.mcp.headers` 时保留认证请求头：优先使用 Claude Code `.mcp.json` 的 `${VAR}` 展开，命令中保留单引号内的变量引用。Codex 的 HTTP Bearer 认证用 `bearer_token_env_var`，其他动态头用 `env_http_headers`（值是变量名），固定头才用 `http_headers`；stdio 凭据通过 `env_vars` 继承。URL 或参数里的占位符不能冒充 Codex 支持的变量展开，按其官方文档在本地处理；命令会进入 shell 历史，不要分享。本地命令的参数、环境变量值和远程 URL 要做 shell 引用，防止空格和尖括号被误解析。Codex 支持 stdio 和 Streamable HTTP，不能把 SSE 地址直接当成 HTTP 配置。
4. 按用户已有授权帮助配置；先检查当前 Agent 的官方支持方式，保留已有配置。由用户在本地填写 Key 和完成账号授权，不要求在对话中发送密钥；未整理的安装字段不能猜测。
5. 配置后验证连接。优先列出工具或执行不产生费用的只读查询，报告实际结果、错误和剩余步骤；写入配置、安装成功与服务可用是不同状态。不能联网或不能修改配置时，明确能力限制并给出下一步。

## 必须遵守

- 本项目仅作独立信息索引，不代表厂商背书、功能实测或安全保证。使用前核对官方文档、安装内容、权限、费用及第三方条款；向用户说明仍未核实的事项。完整使用说明与免责声明：https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer 。
- **涉及资金**（`risk: payment`）的服务可能下单或付款。任何会产生费用的步骤，执行前都要明确告诉用户并等他确认。
- 推荐 `unverified` 条目时，要说明「尚未确认是否为官方出品」；执行安装前先取得厂商官方背书，不把仓库自称官方当作核验证据。
- 索引里找不到，就直说没有收录，不等于没有官方接入，不要编造链接或配置。可以建议用户到 https://github.com/guanmo-ai/awesome-agent-mcp/issues/new?template=submit.yml 提交。
- 本索引不提供任何 Key、账号或付费内容。
