svgl-mcp-server

souravrax/svgl-mcp-server

3.2

If you are the rightful owner of svgl-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The SVGL MCP Server is a modular server designed to provide access to a comprehensive library of SVG logos through a clean and efficient Model Context Protocol.

Tools
4
Resources
0
Prompts
0

SVGL MCP Server

A clean, modular MCP (Model Context Protocol) server for the SVGL API that provides access to a beautiful library of SVG logos.

šŸš€ Features

  • 4 Tools: Get all SVGs, search SVGs, filter by category, get categories
  • 2 Resources: API documentation and dynamic categories overview
  • Type-safe: Full TypeScript support with Zod validation
  • Error handling: Comprehensive error handling with custom error types
  • Modular architecture: Clean separation of concerns

šŸ“ Project Structure

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

šŸ› ļø Available Tools

get_all_svgs

Get all SVGs from the repository

  • Parameters: limit (optional) - Maximum number of SVGs to return

get_categories

Get all available categories with counts

  • Parameters: None

get_svgs_by_category

Filter SVGs by category

  • Parameters: category (required) - Category name to filter by

search_svgs

Search SVGs by title

  • Parameters: query (required) - Search term

šŸ“š Resources

svgl://api-info

Static API documentation and usage information

svgl://categories-overview

Dynamic overview of all categories with live data from the API

šŸ”§ Installation

npm install
npm run build

šŸƒā€ā™‚ļø Running

npm start

šŸ—ļø Architecture

  • API Client: Centralized HTTP client with custom error handling
  • Type Safety: Zod schemas for runtime validation
  • Error Handling: Custom SVGLAPIError class with status codes
  • Modular Design: Clean separation between tools, resources, and API logic
  • Graceful Shutdown: Proper signal handling for clean exits

šŸ“„ License

MIT