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逻辑之间的清晰分离
• 优雅地关闭：清洁出口的正确信号处理

📄 许可证

麻省理工学院