AI导哈

SVG标志管理服务器

一个基于SVGL API的模块化MCP服务器，提供SVG标志库的访问、搜索和分类功能。

  • by souravrax
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 souravrax/svgl-mcp-server

使用说明

SVGL MCP服务器

用于SVGL API的干净、模块化的MCP（模型上下文协议）服务器，提供对漂亮的SVG徽标库的访问。

🚀 特性

  • 4工具：获取所有SVG，搜索SVG，按类别筛选，获取类别
  • 2资源：API文档和动态类别概述
  • 类型安全：通过Zod验证完全支持TypeScript
  • 错误处理：使用自定义错误类型进行全面的错误处理
  • 模块化架构：明确区分关注点

📁 项目结构

src/
├── index.ts      # Main server entry point
├── api.ts        # SVGL API client with error handling
├── tools.ts      # MCP tools registration
├── resources.ts  # MCP resources registration
└── types.ts      # TypeScript interfaces and Zod schemas

🛠️ 可用工具

get_all_svgs

从存储库中获取所有SVG

  • 参数: limit （可选）-返回的最大SVG数量

get_categories

获取所有可用类别及其计数

  • 参数：无

get_svgs_by_category

按类别筛选SVG

  • 参数: category （必填）-要筛选的类别名称

search_svgs

按标题搜索SVG

  • 参数: query （必填）-搜索词

📚 资源

svgl://api-info

静态API文档和使用信息

svgl://categories-overview

使用API的实时数据动态概述所有类别

🔧 安装

npm install
npm run build

🏃‍♂️ 跑步

npm start

🏗️ 建筑

  • API客户端：具有自定义错误处理的集中式HTTP客户端
  • 类型安全：用于运行时验证的Zod模式
  • 错误处理：自定义 SVGLAPIError 带有状态代码的类
  • 模块化设计：工具、资源和API逻辑之间的清晰分离
  • 优雅地关闭：清洁出口的正确信号处理

📄 许可证

麻省理工学院

相关 MCP