LottieFiles MCP Server (Cloudflare Workers)

A remote MCP (Model Context Protocol) server that provides access to the LottieFiles API, deployed on Cloudflare Workers.

Features

Search and discover Lottie animations through these MCP tools:

Tool	Description
search_animations	Search for animations by keywords, tags, and other criteria
get_animation_details	Get detailed info about a specific animation
get_popular_animations	Get currently trending animations
search_animations_by_user	Find animations by a specific creator

Getting Started

Local Development

npm install
npm run dev

The server will be available at http://localhost:8787

Deploy to Cloudflare

npm run deploy

This will deploy your MCP server to: mcp-server-lottiefiles.<your-account>.workers.dev

Endpoints

Endpoint	Transport	Description
/sse	SSE	Server-Sent Events transport
/mcp	HTTP	HTTP transport

Connecting MCP Clients

Cloudflare AI Playground

1. Go to https://playground.ai.cloudflare.com/
2. Enter your MCP server URL: mcp-server-lottiefiles.<your-account>.workers.dev/sse
3. Start using the LottieFiles tools!

Claude Desktop

Add this to your Claude Desktop config (Settings > Developer > Edit Config):

{
  "mcpServers": {
    "lottiefiles": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

For production, replace http://localhost:8787/sse with your deployed URL.

Claude Code

claude mcp add lottiefiles-remote --transport sse http://localhost:8787/sse

Tool Usage Examples

Search Animations

{
  "tool": "search_animations",
  "arguments": {
    "query": "loading spinner",
    "limit": 10
  }
}

Get Animation Details

{
  "tool": "get_animation_details",
  "arguments": {
    "id": "animation-id-here"
  }
}

Get Popular Animations

{
  "tool": "get_popular_animations",
  "arguments": {
    "limit": 20
  }
}

Project Structure

src/
  index.ts           # MCP server entry point with tool definitions
  types.ts           # TypeScript interfaces
  api/
    LottieApiClient.ts  # LottieFiles API client

License

MIT