npm package: @rive-mcp/server-core
Description: Open source MCP server for Rive interactive animations - by Astralis
Author: Gregory Starr : Astralis One LLC
Latest version: 0.1.0

# 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

```bash
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:

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

### Using Programmatically

```typescript
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
```bash
git clone https://github.com/your-username/rive-mcp-server-core.git
cd rive-mcp-server-core
pnpm install
pnpm build
```

### Testing
```bash
# Run tests
pnpm test

# Test with MCP Inspector
pnpm dev

# Test with Claude Desktop
pnpm test:claude
```

## 📖 Documentation

- [Getting Started Guide](./docs/getting-started.md)
- [API Reference](./docs/api-reference.md)
- [Examples](./examples/)
- [Contributing](./CONTRIBUTING.md)

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) 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 →](https://rive-mcp.com/pricing)

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.

## 🙏 Acknowledgments

- [Rive](https://rive.app) for the amazing animation platform
- [Anthropic](https://anthropic.com) for the Model Context Protocol
- [FastMCP](https://github.com/jlowin/fastmcp) for the excellent Python framework

## 📞 Support

- 🐛 [Bug Reports](https://github.com/your-username/rive-mcp-server-core/issues)
- 💡 [Feature Requests](https://github.com/your-username/rive-mcp-server-core/discussions)
- 📧 [Email Support](mailto:support@rive-mcp.com) (Pro customers)
- 💬 [Discord Community](https://discord.gg/rive-mcp)

---

⭐ **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](https://astralis.one).

For enterprise support and commercial licensing, contact: enterprise@astralis.dev