Noun MCP Server

#

Noun MCP服务器

⚠️ 非官方项目 ·这是一个使用The Noun Project API的独立第三方工具。与The Noun Project无关或不受其认可。

MCP（模型上下文协议）服务器，用于在中搜索、下载和使用The Noun Project中的图标 光标AI, 克劳德桌面版，以及其他MCP支持的AI工具。

______________________________________________________________________

🚀 快速开始

光标AI

添加到MCP设置：

{
  "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"
      }
    }
  }
}

克劳德桌面版

添加到配置：

{
  "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"
      }
    }
  }
}

克劳德代码

磨合终端：

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

获取API密钥→

这是什么？ 一个让人工智能助手为您的项目搜索和下载专业图标的桥梁。无需手动浏览，只需询问您的AI即可！

##

特性

图标搜索：查找带有样式、线宽和许可过滤器的图标

图标下载：获取具有自定义颜色和大小的SVG或PNG文件

收藏浏览器：探索精心策划的图标收藏

聪明的建议：自动补全有助于找到正确的搜索词

使用情况跟踪：监控您的API使用情况和限制

免费等级模式：每月5公里API调用的智能优化

付费等级模式：无限制访问

##

需求

• Node.js 18岁或以上(下载)
• Noun项目API密钥 （免费帐户有效！）

没有API密钥？ 把他们带到这儿来→

##

快速开始

###

步骤1：获取API密钥

1. 首选 Noun项目开发商
2. 登录或创建免费帐户
3. 创建新应用程序（或选择现有应用程序）
4. 复制您的 消费者密钥 和 消费者秘密

###

第二步：安装

选项A:npx（最简单-无需安装）

# Run directly without installation
npx @alisaitteke/noun-mcp

选项B：全局安装

npm install -g @alisaitteke/noun-mcp

方案C：地方发展

git clone https://github.com/alisaitteke/noun-mcp.git
cd noun-mcp
npm install
npm run build
npm link

###

步骤3：配置环境

创建 .env 项目目录中的文件：

cp .env.example .env

编辑 .env 使用您的凭据：

# Your API credentials from The Noun Project
NOUN_CONSUMER_KEY=your_consumer_key_here
NOUN_CONSUMER_SECRET=your_consumer_secret_here

# Choose your tier: FREE (5K calls/month) or PAID (unlimited)
NOUN_API_TIER=FREE

####

免费vs

付费等级

免费等级（每月5000次API调用）

非常适合个人项目和测试

自动成本优化

较小的页面大小（每次搜索最多10个结果）

优化缩略图（默认为42px）

默认情况下排除SVG URL（节省带宽）

50%、80%、95%的智能使用警报

付费等级（无限制）

无月度限额

更大的页面大小（最多100个结果）

高质量缩略图（默认为84px）

自动包含SVG URL

无限制

随时切换： 只需更新 NOUN_API_TIER 在你的 .env 文件！

###

步骤4：配置游标AI

打开光标设置： 设置→ 特性→ MCP

添加此配置：

选项A：使用npx（推荐）

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

选项B：使用全局安装

{
  "mcpServers": {
    "noun-project": {
      "command": "noun-mcp",
      "env": {
        "NOUN_CONSUMER_KEY": "your_key_here",
        "NOUN_CONSUMER_SECRET": "your_secret_here",
        "NOUN_API_TIER": "FREE"
      }
    }
  }
}

选项C：使用本地构建

{
  "mcpServers": {
    "noun-project": {
      "command": "node",
      "args": ["/path/to/noun-mcp/dist/index.js"],
      "env": {
        "NOUN_CONSUMER_KEY": "your_key_here",
        "NOUN_CONSUMER_SECRET": "your_secret_here",
        "NOUN_API_TIER": "FREE"
      }
    }
  }
}

###

步骤5：配置Claude桌面

编辑： ~/Library/Application Support/Claude/claude_desktop_config.json

使用npx（推荐）

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

##

用法示例

配置后，只需自然地与您的AI对话：

搜索图标

"Find me some coffee cup icons"
"Search for solid style house icons"
"Show me line icons with weight 18-20 for 'bicycle'"

下载图标

"Download icon 12345 in red color"
"Get icon 67890 as PNG, 200x200 pixels, save to ./icons/house.png"
"Download this icon as SVG with hex color FF5733"

浏览收藏

"Search for weather icon collections"
"Show me collection 123 details"

获取建议

"Give me autocomplete suggestions for 'spo'"

检查使用情况

"How many API calls have I used this month?"
"Check my API usage limits"

##

可用工具

AI可以使用这些工具来帮助您：

search_icons

搜索Noun Project图标数据库。

您可以过滤的内容：

• 风格: solid, line，或两者皆有
• 线宽: 1-60 或类似范围 "18-20"
• 公共领域：仅显示可免费使用的图标
• 缩略图尺寸: 42, 84，或 200 像素
• 包含SVG：在结果中获取SVG URL
• 限制：每页最大结果数

例子：

"Search for 'coffee' icons in solid style, public domain only"

get_icon

获取特定图标的详细信息。

退货：

• 图标名称和ID
• 创建者信息
• 标签和收藏
• 许可证详情
• 下载URL

例子：

"Show me details for icon 12345"

download_icon

下载带有自定义选项的图标。

选项：

• 格式：SVG或PNG
• 颜色：任何十六进制颜色（例如，“FF0000”表示红色）
• 尺寸：20-1200像素（仅PNG）
• 保存到文件：可选文件路径

注： 免费版只能下载公共域图标。

例子：

"Download icon 12345 as PNG, 200x200, red color, save to ./icons/coffee.png"

search_collections

按关键字查找图标集合。

例子：

"Search for 'travel' collections"

get_collection

查看特定收藏及其所有图标。

例子：

"Show me collection 456"

icon_autocomplete

获取搜索词建议（最多10个）。

例子：

"What terms start with 'comp'?"

check_usage

检查您的API使用情况和限制。

显示：

• 每月限额和使用量
• 剩余通话
• 使用百分比
• 重置前的天数
• 优化技巧（免费等级）

##

免费等级最佳实践

最大化您每月5000次通话：

1.具体点

Bad:  "icon"       → Too broad, many pages needed
Good: "coffee cup" → Specific, better results

2.先使用自动补全

Step 1: "Suggestions for 'cof'"  → ["coffee", "coffee cup"]
Step 2: "Search for 'coffee cup'" → Exact results

3.避免分页

Bad:  Browsing 5 pages = 5 API calls
Good: Refine search to get results on first page

4.下载一次，重复使用

Download icon → Save to project → Use everywhere
(Don't re-download the same icon)

5.公共域筛选器

FREE tier can only download public domain icons
Filter searches with limit_to_public_domain=1

6.缓存结果

服务器会自动缓存使用数据5分钟。 您还应该保存：

• 已下载图标
• 您探索过的图标ID
• 收集信息

##

成本优化

服务器在免费层模式下自动优化API的使用：

想要完整的细节吗？ 看 成本调整.md

##

发展

以开发模式运行

npm install
npm run dev

为生产而建

npm run build

运行构建版本

npm start

项目结构

noun-mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── api/
│   │   ├── auth.ts          # OAuth 1.0a authentication
│   │   └── client.ts        # API client with rate limiting
│   ├── tools/
│   │   ├── search.ts        # Icon search functionality
│   │   ├── download.ts      # Icon download & details
│   │   ├── collections.ts   # Collections & autocomplete
│   │   └── usage.ts         # Usage monitoring
│   ├── types/
│   │   └── schemas.ts       # Zod schemas & TypeScript types
│   └── utils/
│       └── costOptimizer.ts # Cost optimization logic
├── package.json
├── tsconfig.json
└── README.md

##

故障排除

“缺少必需的环境变量”

问题： 找不到API密钥。

解决方案：

1. 检查 .env 文件存在
2. 验证 NOUN_CONSUMER_KEY 和 NOUN_CONSUMER_SECRET 已设定
3. 检查变量名中的拼写错误

“身份验证失败”

问题： API凭据无效。

解决方案：

1. 在以下位置验证凭据 开发者页面
2. 确保你复制了整个密钥/秘密
3. 检查是否有多余的空格或引号

“超出费率限制”

问题： 请求太多太快。

解决方案：

• 请稍等（限制为每分钟100个请求）
• 服务器自动处理速率限制
• 如果持续存在，请检查您的使用情况 check_usage 工具

SVG URL不工作

问题： SVG URL将在1小时后过期。

解决方案：

• 需要时下载新网址
• 使用 download_icon 获取base64编码的图标
• 在本地保存图标，而不是依赖URL

“API免费访问仅限于公共域图标”

问题： 尝试使用免费帐户下载非公共域图标。

解决方案：

• 筛选搜索： limit_to_public_domain=1
• 或升级至付费等级 定价页面

服务器未出现在Cursor/Claude中

问题： 未检测到MCP服务器。

解决方案：

1. 重新启动Cursor AI或Claude Desktop
2. 检查JSON配置语法（没有尾随逗号！）
3. 验证文件路径是否为绝对路径
4. 检查服务器日志是否有错误

##

API限值

想要更多吗？ 检查 Noun项目定价

##

贡献

欢迎投稿！

1. 分叉存储库
2. 创建要素分支： git checkout -b feature/amazing-feature
3. 提交更改： git commit -m 'Add amazing feature'
4. 推送到分支： git push origin feature/amazing-feature
5. 打开拉取请求

##

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

##

致谢

• Noun项目 -对于令人惊叹的图标系列
• 模型上下文协议 -对于MCP规范
• Anthropic -用于Claude和MCP开发

##

作者

阿里·赛特·泰克

• github： @阿利塞特
• NPM： @阿利塞特

##

支持

• 问题：
• 文档： 新项目API文档
• 定价： Noun项目计划

##

链接

• Noun项目
• API Noun项目
• MCP文件
• 光标AI
• 克劳德

______________________________________________________________________

注： 这是一个社区构建的MCP服务器，不是The Noun Project的官方产品。

由...制作

对于人工智能和开发人员社区。