# rc-adapty-migration-mcp
## 基本信息
- Slug: `ferrousguy-rc-adapty-migration-mcp`
- Source: modelscope
- Publisher: @ferrousguy/rc-adapty-migration-mcp
- Categories: rag-systems / app-automation
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@ferrousguy/rc-adapty-migration-mcp
## 简介
暂无描述。
## 安装提示

```bash
git clone <repository-url> cd rc-adapty-migration-mcp
```

## MCP Server 详情

# RevenueCat to Adapty Migration MCP

A Model Context Protocol (MCP) server that helps users migrate their subscription business from RevenueCat to Adapty. This MCP provides tools for data export, analysis, and automated migration through natural language interactions with LLMs like Claude Desktop.

## Features

- **RevenueCat Data Export**: Hierarchical export of projects, offerings, packages, products, and entitlements
- **Migration Analysis**: Assess migration complexity and generate recommendations
- **Automated Migration**: Create Adapty apps, access levels, and products from RevenueCat data
- **Validation**: Verify migration success and data integrity
- **LLM Integration**: Natural language interface for migration tasks

## Installation

### Prerequisites

- Python 3.8 or higher
- RevenueCat API key (v2)
- Adapty account (email/password for authentication)

### Local Installation

1. **Clone the repository:**

   ```bash
   git clone <repository-url>
   cd rc-adapty-migration-mcp
   ```

2. **Create a virtual environment:**

   ```bash
   python3 -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   ```

3. **Install the package:**

   ```bash
   pip install -e .
   ```

4. **Set up environment variables:**
   ```bash
   export REVENUECAT_API_KEY="your_revenuecat_api_key"
   ```

## Configuration

### Environment Variables

- `REVENUECAT_API_KEY`: Your RevenueCat secret API key (required)
- `REVENUECAT_PROJECT_ID`: Optional RevenueCat project ID
- `LOG_LEVEL`: Optional logging level (INFO, DEBUG, etc.)

### Adapty Authentication

**Important**: Adapty uses username/password authentication, not API keys. Your Adapty credentials are provided at runtime when calling migration tools and are not stored permanently.

### MCP Configuration

Create an MCP configuration file (e.g., `mcp-config.json`):

```json
{
  "mcpServers": {
    "rc-adapty-migration": {
      "command": "rc-adapty-migration-mcp",
      "env": {
        "REVENUECAT_API_KEY": "your_revenuecat_api_key"
      }
    }
  }
}
```

## Usage

### With Claude Desktop

1. **Configure Claude Desktop** to use this MCP server
2. **Ask natural language questions** like:
   - "Export my RevenueCat data and analyze the structure"
   - "Migrate my RevenueCat setup to Adapty using my email and password"
   - "Validate that my migration was successful"

### Available Tools

#### 1. Export RevenueCat Data

```json
{
  "name": "export_revenuecat_data",
  "arguments": {
    "output_format": "summary"
  }
}
```

#### 2. Analyze RevenueCat Structure

```json
{
  "name": "analyze_revenuecat_structure",
  "arguments": {
    "analysis_depth": "detailed"
  }
}
```

#### 3. Migrate to Adapty

```json
{
  "name": "migrate_to_adapty",
  "arguments": {
    "adapty_email": "user@example.com",
    "adapty_password": "your_password",
    "migration_scope": "full"
  }
}
```

**Security Note**: When using the migration tool, your Adapty credentials are only used for the specific migration operation and are not stored or logged.

## Deployment Options

### Option 1: Local Installation (Recommended for Testing)

Users install the MCP locally on their machine:

1. **Install the package** using pip
2. **Configure environment variables** (RevenueCat API key only)
3. **Point their LLM** to the local installation
4. **Provide Adapty credentials** at runtime when needed

**Pros:**

- Full control over data and credentials
- No network dependencies
- Easy to debug and customize
- No hosting costs
- Adapty credentials never stored

**Cons:**

- Requires technical setup
- Users must manage their own environment

### Option 2: Hosted Service

Deploy the MCP as a hosted service:

1. **Deploy to cloud platform** (AWS, GCP, Azure)
2. **Set up authentication** for users
3. **Provide web interface** or API endpoints

**Pros:**

- No local setup required
- Centralized management
- Easy updates and monitoring

**Cons:**

- Requires hosting infrastructure
- Security considerations for user credentials
- Network dependencies

## Development

### Project Structure

```
rc-adapty-migration-mcp/
 src/rc_adapty_migration/
    api/
       revenuecat.py      # RevenueCat API client
       adapty.py          # Adapty API client
    auth/
       credentials.py     # Credential management
    models/
       revenuecat.py      # Data models
    tools/                 # Migration tools
    utils/
       logging.py         # Logging utilities
    server.py              # MCP server implementation
 tests/                     # Test files
 pyproject.toml            # Project configuration
 README.md                 # This file
```

### Running Tests

```bash
# Run all tests
pytest

# Run specific test
pytest tests/test_revenuecat_export.py

# Run with coverage
pytest --cov=src/rc_adapty_migration
```

### Testing the MCP

1. **Test RevenueCat export:**

   ```bash
   python test_revenuecat_full_chain.py
   ```

2. **Test Adapty migration:**
   ```bash
   python test_adapty_full_chain.py
   ```

## Security Considerations

- **RevenueCat API Key**: Stored in environment variables
- **Adapty Credentials**: Provided at runtime, never stored
- **Network**: Use HTTPS for all API communications
- **Validation**: Validate all user inputs and API responses
- **Logging**: No sensitive credentials are logged

## Troubleshooting

### Common Issues

1. **"API key not found"**

   - Ensure `REVENUECAT_API_KEY` environment variable is set
   - Verify the API key is valid and has proper permissions

2. **"Login failed"**

   - Check Adapty credentials
   - Ensure the account has proper permissions

3. **"No projects found"**
   - Verify RevenueCat account has projects
   - Check API key permissions

### Debug Mode

Enable debug logging:

```bash
export LOG_LEVEL=DEBUG
rc-adapty-migration-mcp
```

## Contributing

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

## License

MIT License - see LICENSE file for details…