Streamline MCP Server

Streamline MCP Server

Streamline MCP Server 为 Cursor 或 Claude Desktop 等兼容 MCP 的客户端提供一组工具，用于访问 Streamline 的完整 图标、插画、元素和表情符号集合。
客户端可以用 PNG 或 SVG 格式搜索、获取和下载资源。

---

🧩 设置与身份验证

Streamline MCP Server 的地址为：

https://public-api.streamlinehq.com/mcp

有两种身份验证方式。请选择适合你客户端的方式。

🔐 选项 1 — OAuth（推荐用于 Claude Desktop 和 Web）

支持自定义连接器的图形界面客户端可以通过 OAuth 进行身份验证，无需复制或保存 API 密钥。

1. 在 Claude 中，前往 设置 → 连接器 → 添加自定义连接器。
2. 为其命名（例如 Streamline MCP），然后输入上方的服务 URL。
3. 点击 连接 — 系统会将你重定向到 Streamline Web 应用，以便登录并授予访问权限。
4. 返回 设置 → 连接器，确认服务显示 已连接状态。

完整详情请参阅 Claude 连接器指南。

🔑 选项 2 — API 密钥（X-API-Key 标头）

基于配置或命令行的客户端（例如 Cursor、Claude Code CLI）使用 API 密钥进行身份验证。
可在 Streamline 账户 → API 设置页面生成和管理密钥。

JSON 配置：

{
  "mcpServers": {
    "streamline": {
      "url": "https://public-api.streamlinehq.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code CLI：

claude mcp add --transport http streamline-mcp \
  https://public-api.streamlinehq.com/mcp \
  --header "X-API-Key: YOUR_API_KEY_HERE"

---

⚙️ 用法

连接后，客户端的 AI 聊天即可调用以下任意工具。完整参数和示例请参阅 Streamline MCP 参考文档。

术语： Family 是顶级资源包（例如 “Ultimate”），Set 是 Family 中的样式变体（例如 “Ultimate Regular”）。

🔎 搜索与发现

• search_assets — 在资源目录中搜索单个图标、插画、元素和表情符号，也可以限定在特定 Set 或 Family 中搜索。
• search_sets — 按描述或主题搜索 Set（样式变体）。
• find_sets_by_name — 按名称查找 Set。
• get_all_families — 浏览账户可用的所有 Family（资源包）。
• get_all_sets_from_family — 列出指定 Family 中的所有 Set。
• get_family_extra_details — 获取 Family 的描述和语义背景信息。

📥 获取与下载

• get_icon_by_hash — 通过唯一哈希获取指定图标。
• download_asset — 以 PNG 或 SVG 格式下载单个资源，并可设置尺寸、颜色、背景和描边选项。
• download_multiple_assets — 一次调用批量下载多个资源。

示例：
让客户端的 AI 聊天搜索“狗图标”。
MCP 客户端会自动调用适当的工具，并返回 Streamline 中匹配的结果。

---

🌟 主要功能

• 搜索图标、插画、元素和表情符号。
• 获取指定资源的详细元数据。
• 以 PNG 或 SVG 格式下载资源，并可自定义尺寸、颜色、背景和描边。
• 完全兼容所有 MCP 协议客户端。

---

💡 使用场景

• 快速查找用于 Web 或移动端设计项目的图标。
• 获取并自定义用于设计系统或创意工作流的资源。
• 在应用中自动执行图标相关任务，或构建工具。

---

❓ 常见问题

哪些客户端可以使用 Streamline MCP Server？

任何兼容 MCP 的客户端（例如 Cursor、Claude Desktop）都可以通过提供的 JSON-RPC 端点连接。

可以下载多种格式的图标吗？

可以，支持 PNG 和 SVG，并可自定义尺寸和颜色。

需要进行身份验证吗？

需要。你可以通过 OAuth（推荐用于 Claude Desktop/Web）或使用 API 密钥（命令行或配置客户端使用 X-API-Key 标头）进行身份验证。详情请参阅设置与身份验证部分。

---

🙋 需要帮助？

想直接联系 Streamline 开发团队？加入我们的公开 Slack 频道，向团队提问、分享反馈，并直接向开发人员寻求 MCP 服务的设置帮助。