Noun Project MCP Server

Noun Project MCP服务器

用于The Noun Project API的模型上下文协议（MCP）服务器，使Claude Code能够以编程方式搜索和检索图标。

特性

• 图标搜索：搜索具有高级过滤器（样式、线宽、公共域）的图标
• 图标详细信息：获取特定图标的详细信息
• 集合：检索图标集合
• 自动完成：获取搜索词建议
• 使用情况跟踪：监视API配额和使用情况
• 下载URL：获取带有颜色和尺寸选项的自定义下载链接

先决条件

1. Node.js：版本18或更高版本
2. Noun项目API证书：从获取API密钥和机密 Noun项目

安装

快速安装（推荐）

直接从npm安装，并在一个命令中添加到Claude Code中：

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- npx -y noun-project-mcp

替换 your_api_key_here 和 your_api_secret_here 您的真实凭据来自 Noun项目.

本地开发

1. 克隆并导航到存储库：

git clone https://github.com/sgup/noun-project-mcp.git
cd noun-project-mcp

1. 安装依赖项：

npm install

1. 构建TypeScript代码：

npm run build

1. 使用本地路径添加到Claude代码：

claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_api_key_here \
  --env NOUN_PROJECT_API_SECRET=your_api_secret_here \
  -- node /absolute/path/to/noun-project-mcp/dist/index.js

可用工具

1.搜索图标

搜索具有各种过滤器的图标。

参数：

• query （必填）：搜索词（例如“狗”、“房子”）
• styles （可选）：按样式筛选-“实线”、“直线”或“实线、直线”
• line_weight （可选）：对于线条图标，指定权重（1-60）或范围（例如“18-20”）
• limit_to_public_domain （可选）：仅对公共域设置为1
• thumbnail_size （可选）：42、84或200像素
• include_svg （可选）：设置为1以包含SVG URL
• limit （可选）：最大结果数

例子：

{
  "query": "dog",
  "styles": "line",
  "limit": 10
}

2.get_icon

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

参数：

• icon_id （必填）：图标的唯一ID
• thumbnail_size （可选）：42、84或200像素

例子：

{
  "icon_id": 12345,
  "thumbnail_size": 200
}

3.收集

检索收藏及其图标。

参数：

• collection_id （必填）：集合的唯一ID
• thumbnail_size （可选）：42、84或200像素
• include_svg （可选）：设置为1以包含SVG URL
• limit （可选）：返回的最大图标数

例子：

{
  "collection_id": 123
}

4.图标自动补全

获取搜索词的自动补全建议。

参数：

• query （必填）：部分搜索词
• limit （可选）：建议的最大数量

例子：

{
  "query": "hom",
  "limit": 5
}

5.检查使用

检查当前API使用情况和限制。

参数： 无

6.get_download_url

获取具有自定义功能的图标的下载URL。

参数：

• icon_id （必填）：图标的唯一ID
• color （可选）：十六进制颜色（例如“FF0000”）
• filetype （可选）：“svg”或“png”
• size （可选）：对于PNG，以像素为单位的大小（20-1200）

例子：

{
  "icon_id": 12345,
  "color": "FF0000",
  "filetype": "png",
  "size": 512
}

发展

在开发模式下运行并自动重建：

npm run dev

生产建设：

npm run build

启动服务器：

npm start

API 参考

此MCP服务器使用The Noun Project API v2。有关API的更多详细信息：

• API 文档
• 迁移指南

认证

Noun Project API使用OAuth 1.0身份验证。此服务器使用您的API凭据自动处理所有OAuth签名。

使用限制

Noun Project API有每月使用限制。使用 check_usage 监控配额的工具。

故障排除

“必须设置NOUN_PROJECT_API_KEY和NOUN_PROJECT_API_SECRET”

确保你包括 --env 跑步时的标志 claude mcp add。您可以通过以下方式验证您的配置：

claude mcp list

要更新您的凭据，请删除并重新添加服务器：

claude mcp remove noun-project
claude mcp add --transport stdio noun-project \
  --env NOUN_PROJECT_API_KEY=your_new_key \
  --env NOUN_PROJECT_API_SECRET=your_new_secret \
  -- npx -y noun-project-mcp

“无效签名”错误

验证您的API密钥和机密是否正确，并且尚未在Noun Project仪表板中重新生成。

连接问题

请确保您有一个活跃的互联网连接，并且可以访问The Noun Project API。

许可证

麻省理工学院

支持

对于此MCP服务器的问题，请在存储库中提交问题。

有关The Noun Project API的问题，请访问他们的 支持页面.