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:

Related MCP server: Cloudflare MCP Server for Static Sites

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

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