Rive MCP Server - Open Source Core

An open source Model Context Protocol (MCP) server that bridges AI assistants with Rive interactive animations, enabling natural language animation discovery, code generation, and integration.

🚀 Features

Open Source Core (Free)

• Animation Discovery: Search and browse public Rive community animations
• Basic Code Generation: Generate React and vanilla JavaScript integration code
• File Analysis: Parse .riv file structure and extract metadata
• Community Tools: Browse public animations with basic filtering
• MCP Integration: Full Model Context Protocol server implementation

Pro Features (Coming Soon)

• Advanced code generation with TypeScript and enterprise patterns
• Real-time preview generation (CodeSandbox/StackBlitz)
• Performance analysis and optimization recommendations
• AI-powered animation recommendations
• Enterprise integrations and priority support

🏗️ Architecture

This project follows an open core model:

• Core: Open source MCP server with essential animation tools
• Pro: Commercial extensions with advanced features and enterprise support

📦 Installation

npm install @rive-mcp/server-core
# or
pnpm add @rive-mcp/server-core

🚀 Quick Start

Using with Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcp": {
    "servers": {
      "rive-animation-assistant": {
        "command": "npx",
        "args": ["@rive-mcp/server-core"],
        "env": {}
      }
    }
  }
}

Using Programmatically

import { RiveMCPServer } from '@rive-mcp/server-core';

const server = new RiveMCPServer({
  name: "rive-animation-assistant",
  version: "1.0.0"
});

await server.start();

🛠️ Development

Prerequisites

• Node.js 18+
• pnpm (recommended) or npm

Setup

git clone https://github.com/your-username/rive-mcp-server-core.git
cd rive-mcp-server-core
pnpm install
pnpm build

Testing

# Run tests
pnpm test

# Test with MCP Inspector
pnpm dev

# Test with Claude Desktop
pnpm test:claude

📖 Documentation

• Getting Started Guide
• API Reference
• Examples
• Contributing

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📋 Roadmap

Phase 1: Core Features (Current)

• [x] Basic MCP server setup
• [ ] Animation discovery and search
• [ ] Basic code generation
• [ ] File analysis tools

Phase 2: Enhanced Features

• [ ] Advanced search and filtering
• [ ] Multi-framework code generation
• [ ] Performance recommendations
• [ ] Community integration

Phase 3: Pro Features

• [ ] Real-time previews
• [ ] AI-powered recommendations
• [ ] Enterprise integrations
• [ ] Advanced analytics

💼 Commercial Support

Looking for advanced features, enterprise support, or custom integrations?

• Pro Plan: $29/month per developer
• Enterprise: $299/month per team
• Custom Solutions: Contact us for pricing

Learn more about Pro features →

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Rive for the amazing animation platform
• Anthropic for the Model Context Protocol
• FastMCP for the excellent Python framework

📞 Support

• 🐛 Bug Reports
• 💡 Feature Requests
• 📧 Email Support (Pro customers)
• 💬 Discord Community

⭐ Star this repo if you find it useful! It helps others discover the project.

🏢 About

Rive MCP Server is developed and maintained by Astralis.one.

For enterprise support and commercial licensing, contact: [email protected]