noun-mcp

Noun MCP

语言： English · 简体中文 · Español · Deutsch · 日本語 · Türkçe

用日常语言描述图标需求。 描述你需要什么——“一个实心咖啡杯，公有领域”—— 你的 AI 助手便会搜索 The Noun Project，挑选合适的图标，并将 SVG 或 PNG 下载到 你的项目中。支持 Cursor、Claude Desktop 和 Claude Code。

注意： 这是一个非官方的社区维护项目，与 The Noun Project 无关联，也未获其认可。

它能做什么？

• 搜索 — 按风格、线条粗细和公有领域许可筛选
• 下载 — 支持 SVG 或 PNG、自定义颜色和尺寸，并保存到你指定的路径
• 浏览合集 — 查看精选图标集，而不仅限于单次搜索
• 自动补全 — 在消耗配额前获取更合适的搜索词
• 跟踪用量 — 查看每小时、每日和每月的服务调用与图标调用额度
• 延长免费试用 — 客户端用量限制，让每月 150 次图标调用更耐用

底层共提供 7 个工具 — 完整列表见 docs/available-tools.md。

试着这样说

Find solid public-domain coffee cup icons, then download one as a red SVG into ./icons.

Suggest search terms for "spo", then search weather collections.

How many Noun Project API calls have I used this month?

快速开始

你需要 Node.js 18+ 和 Noun Project API 密钥（创建应用 — 免费账户即可）。将 NOUN_API_TIER 设为 FREE（每月 2,000 次服务调用 / 150 次图标调用）或 PAID。配额详情：docs/available-tools.md。

安装后，将 your_key / your_secret 替换为你的 Consumer Key 和 Secret。

Claude Code：

claude mcp add \
  --transport stdio \
  noun-project \
  --env NOUN_CONSUMER_KEY=your_key \
  --env NOUN_CONSUMER_SECRET=your_secret \
  --env NOUN_API_TIER=FREE \
  -- npx -y @alisaitteke/noun-mcp

或者，将以下内容添加到 MCP 客户端的配置中（Cursor、Claude Desktop 等）：

{
  "mcpServers": {
    "noun-project": {
      "command": "npx",
      "args": ["-y", "@alisaitteke/noun-mcp"],
      "env": {
        "NOUN_CONSUMER_KEY": "your_key",
        "NOUN_CONSUMER_SECRET": "your_secret",
        "NOUN_API_TIER": "FREE"
      }
    }
  }
}

现成的配置文件：examples/cursor-config.json、examples/claude-desktop-config.json。

工作原理

1. 用自然语言输入你想要的内容。
2. AI 会先搜索——search_icons 是低成本的服务调用，并会直接返回 ID、许可证和缩略图。
3. 仅在需要文件时下载——每次调用 download_icon / get_icon 都会消耗一次图标调用额度。

遇到配额错误？请调用 check_usage，然后等待或调整搜索条件。常见解决方法：docs/troubleshooting.md。

文档

• 可用工具 — 全部 7 个工具、参数以及免费与付费选项
• 故障排除 — 密钥、429 错误和公有领域下载
• 架构 — OAuth、队列、重试和缓存
• 开发 — 从源代码构建和测试

贡献

欢迎贡献！提交 PR 前，请先阅读 CONTRIBUTING.md。

维护者

由 Ali Sait Teke 构建 — GitHub · LinkedIn。

许可证

MIT