# API 与 MCP（开发中）

## 现状

icons.motucloud.com 是浏览站，**没有**按需返回 SVG 的接口，也不是 Iconify 官方接口的替代。现在程序取图标请用：

- npm：`@iconify/json/json/{前缀}.json`
- Iconify 官方 API：`https://api.iconify.design/{前缀}/{图标名}.svg`

以上两种只适用于来自 Iconify 的图标集。本站增补集（`motu-` 等前缀）目前只能在本站复制或打包下载。

## API（开发中）

计划在独立域名 api.motucloud.com 提供与 Iconify 兼容的接口（按 ID 取 SVG、按图标集取 JSON 等），主要给 WordPress 插件、构建脚本和内部工具使用。API 与浏览站分开部署，互不影响。

尚未开放。上线后本页会补充接口地址和示例。

## MCP（开发中）

MCP（Model Context Protocol）让 Cursor、Claude Code 等客户端以工具的方式查图标。计划中的能力：

- 按 `前缀:图标名` 返回 SVG；
- 按关键词返回匹配的图标 ID 列表；
- 读取某套图标的许可、作者和原仓库链接。

MCP 开放后会挂在 API 的域名下，不放在浏览站下面。开放时间和接入地址以站内 /mcp 页和本页更新为准。

<!-- TODO(待确认)：MCP 收录范围是否与站内图标集完全一致、有哪些排除，开放后再写。 -->