# RDRS MCP Server

Model Context Protocol (MCP) server for Rocket Data Replicate and Sync (RDRS).

## Overview

This MCP server provides a natural language interface to interact with RDRS through AI assistants like GitHub Copilot, Claude Desktop, and Cline. It connects to your local RDRS installation and exposes comprehensive tools for managing agents, data sources, processes, and replication tasks.

## Prerequisites

- **RDRS 7.0+** installed and running locally
- **Python 3.8+**
- **Java 8+** (required by RDRS)
- RDRS REST API running (default: `http://localhost:8080`)

## Installation

### 1. Clone the Repository

```bash
git clone https://github.com/myunussheikhRS/rdrs_MCP.git
cd rdrs_MCP
```

### 2. Set Up Python Environment

```bash
# Create virtual environment
python -m venv .venv

# Activate virtual environment
# Windows:
.venv\Scripts\activate
# Linux/Mac:
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt
```

### 3. Configure MCP Client

#### GitHub Copilot (VS Code)

Add to `%APPDATA%\Code\User\globalStorage\github.copilot-chat\mcp.json`:

```json
{
  "mcpServers": {
    "rdrs": {
      "command": "python",
      "args": [
        "c:\\path\\to\\rdrs_MCP\\rdrs_server_fixed.py"
      ],
      "env": {
        "RDRS_URL": "http://127.0.0.1:8080"
      }
    }
  }
}
```

#### Claude Desktop

Add to `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json
{
  "mcpServers": {
    "rdrs": {
      "command": "python",
      "args": [
        "/path/to/rdrs_MCP/rdrs_server_fixed.py"
      ],
      "env": {
        "RDRS_URL": "http://127.0.0.1:8080"
      }
    }
  }
}
```

### 4. Restart Your MCP Client

Restart GitHub Copilot/Claude Desktop to load the RDRS MCP server.

## Features

### Agent Management
- Get active agents
- List defined agents
- Add/update/delete agents
- Test agent connectivity

### Data Source Management
- List data sources
- Add/configure data sources
- Test data source connectivity
- Support for Oracle, DB2, PostgreSQL, MySQL, MSSQL, and more

### Process Management
- List active/defined/terminated processes
- Start/stop processes
- Get process statistics and latency
- Monitor process health

### Health Check
- System prerequisites validation
- Java installation check
- Port availability verification
- RDRS connectivity test
- Database environment detection

## Usage Examples

Once configured, interact with RDRS through natural language:

```
"Get active RDRS agents"
"List all defined processes"
"Show me the health check status"
"Start process OrderSync"
"Get statistics for process CustomerReplication"
```

## Available Tools

The server exposes 50+ tools including:

- `rdrs_get_active_agents()` - Get all active agents
- `rdrs_list_defined_processes()` - List process definitions
- `rdrs_start_process(name)` - Start a process
- `rdrs_get_process_statistics(name, pid)` - Get process stats
- `rdrs_health_check()` - Comprehensive system check
- And many more...

## Configuration

### Environment Variables

- `RDRS_URL` - RDRS REST API endpoint (default: `http://127.0.0.1:8080`)

### RDRS Ports

- **4135** - RDRS Agent communication port
- **8080** - RDRS REST API port (configurable)

## Security

⚠️ **Important**: This MCP server is designed for **local use only**. It connects to your local RDRS installation and should NOT be exposed publicly without proper authentication and security measures.

## Troubleshooting

### MCP Server Not Connecting

1. Ensure RDRS is running: Check Task Manager for `tcvm.exe`
2. Verify RDRS_URL is correct
3. Check firewall settings for port 4135/8080
4. Run health check: Ask "Run RDRS health check"

### No Active Agents

1. Verify RDRS agent is started
2. Check agent configuration in RDRS
3. Ensure structure repository is accessible

### Connection Errors

1. Verify RDRS REST API is enabled
2. Check `RDRS_URL` environment variable
3. Ensure no SSL certificate issues

## Documentation

- [RDRS Installation Guide](https://wiki.rocketsoftware.com/pages/viewpage.action?spaceKey=Shadow&title=Initial+setup)
- [RDRS Configuration](https://docs.rocketsoftware.com/bundle/datareplicate_sync_7/page/vey1761626889125.html)
- [Model Context Protocol](https://modelcontextprotocol.io/)

## Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

## License

Copyright © 2025 Rocket Software, Inc.

## Support

For RDRS-related issues, contact Rocket Software support.
For MCP server issues, please open a GitHub issue.