thiings MCP

Thiings图标搜索MCP服务器

此MCP（模型上下文协议）服务器允许您从Thiings网站搜索和下载图标(https://www.thiings.co/things)直接进入你的项目。 针对Cursor进行了优化！

特性

• 搜索图标：使用关键字在Thiings网站上搜索图标
• 下载图标：按URL下载特定图标
• 一键下载：在一个命令中搜索并下载第一个匹配的图标
• 自动组织：图标将保存到您的项目目录中
• 光标集成：易于设置和配置Cursor

光标快速设置

1. 运行安装脚本:

   python3 setup_cursor.py

1. 重新启动游标 加载MCP服务器

1. 开始使用它 在光标聊天中：

   "Search for home icons on the Thiings website"

就是这样！安装脚本将自动执行以下操作：

• 安装所有依赖项
• 为Cursor配置MCP服务器
• 创建使用文档

手动安装

如果您更喜欢手动设置：

1. 再进行:

   pip install -r requirements.txt

1. 配置光标：创建或编辑 .cursor/mcp.json 在您的项目中：

   {
     "mcpServers": {
       "thiings-icon-search": {
         "command": "python3",
         "args": ["thiings_icon_mcp.py"],
         "cwd": ".",
         "description": "Search and download icons from the Thiings website"
       }
     }
   }

1. 重新启动游标 加载新的MCP服务器

可用工具

1. search_thiings_icons

在Thiings网站上搜索图标。

参数：

• query （可选）：搜索查询以查找特定图标

例子：

{
  "query": "home"
}

2. download_thiings_icon

从URL下载特定图标。

参数：

• icon_url （必填）：要下载的图标的URL
• filename （必填）：下载图标的文件名
• output_dir （可选）：保存图标的目录（默认：当前目录）

例子：

{
  "icon_url": "https://www.thiings.co/icons/home.svg",
  "filename": "home_icon.svg",
  "output_dir": "./icons"
}

3. search_and_download_icon

搜索图标并自动下载第一场比赛。

参数：

• query （必填）：查找图标的搜索查询
• output_dir （可选）：保存图标的目录（默认：当前目录）

例子：

{
  "query": "settings",
  "output_dir": "./assets/icons"
}

使用示例

基本搜索

Use the search_thiings_icons tool to find icons related to "navigation"

下载特定图标

Download the icon from https://www.thiings.co/icons/user.svg and save it as "user_icon.svg"

快速搜索和下载

Search for a "hamburger menu" icon and download the first result to the ./icons directory

文件结构

thiings_mcp/
├── server.py              # Main MCP server implementation
├── requirements.txt       # Python dependencies
├── mcp_config.json       # MCP server configuration
└── README.md             # This file

技术细节

运作原理

1. Web剪贴：服务器使用 aiohttp 和 BeautifulSoup 浏览Thiings网站
2. 图标检测：它使用CSS选择器搜索常见的图标模式
3. 下载管理：图标异步下载并保存到指定目录
4. 重复处理：服务器根据URL删除重复的图标

图标检测策略

服务器使用以下CSS选择器查找图标：

• img[src*="icon"] -src属性中带有“icon”的图像
• img[alt*="icon"] -alt文本中带有“图标”的图像
• .icon img -图标类中的图像
• [class*="icon"] img -具有图标相关类的元素中的图像
• svg[class*="icon"] -带有图标类的SVG元素
• .thing img -“事物”元素中的图像
• [class*="thing"] img -事物相关元素中的图像

错误处理

该服务器包括全面的错误处理功能，用于：

• 网络故障
• URL无效
• 文件系统错误
• HTML分析错误

发展

要在本地测试服务器，请执行以下操作：

# Install dependencies
pip install -r requirements.txt

# Run the server (for testing)
python server.py

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

许可证

这个项目是开源的，可以在MIT许可证下使用。

备注

• 服务器尊重Thiings网站的结构，如果网站发生变化，可能需要更新
• 下载的图标保留其原始格式（PNG、SVG等）
• 如果输出目录不存在，服务器会自动创建输出目录
• 使用流媒体高效下载大图标