RegGuard

Verificación de cumplimiento normativo impulsada por IA para contenido de marketing financiero en múltiples jurisdicciones.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de RegGuard 🛡️

Servidor de Cumplimiento de Marketing Financiero Mejorado con IA usando Protocolo de Contexto de Modelo (MCP)

RegGuard es un sofisticado servidor MCP (Protocolo de Contexto de Modelo) que proporciona verificación de cumplimiento regulatorio impulsada por IA para contenido de marketing financiero. Aprovecha el modelo GPT-4o-mini de OpenAI combinado con conocimiento regulatorio específico de cada jurisdicción para detectar violaciones en múltiples mercados financieros.

🎯 ¿Qué Hace RegGuard?

RegGuard actúa como un asistente de cumplimiento inteligente que:

🔍 Analiza Contenido de Marketing: Utiliza IA para escanear materiales de marketing financiero en busca de violaciones regulatorias
🌍 Soporte Multi-Jurisdicción: Cubre regulaciones de Singapur (SG), Hong Kong (HK), EAU (AE) e India (IN)
⚡ Verificación de Cumplimiento en Tiempo Real: Se integra perfectamente con asistentes de IA como Claude y Cursor
📋 Inserción Automática de Descargos: Coloca inteligentemente los descargos regulatorios requeridos
📊 Generación de Registros de Auditoría: Mantiene registros a prueba de manipulaciones de todas las verificaciones de cumplimiento
🎯 Análisis de IA Contextual: Va más allá de la coincidencia de patrones para comprender matices regulatorios

🧠 Conceptos Clave y Recursos Educativos

Entendiendo MCP (Protocolo de Contexto de Modelo)

Documentación Oficial de MCP - Aprende sobre el estándar abierto para conectar asistentes de IA a sistemas externos
Repositorio GitHub de MCP - Especificación técnica y ejemplos
Guía de Anthropic para Crear Servidores MCP - Guía paso a paso para crear servidores MCP

Fundamentos de Cumplimiento Regulatorio Financiero

Directrices MAS sobre Trato Justo (Singapur) - Regulaciones de marketing financiero de Singapur
Directrices SFC sobre Anuncios de Inversión (Hong Kong) - Reglas de marketing de valores de Hong Kong
Reglas de Conducta DFSA (EAU) - Regulaciones de servicios financieros de Dubái
Directrices SEBI (India) - Regulaciones de la Junta de Valores y Bolsa de la India

Tecnología de Cumplimiento Impulsada por IA

Documentación de la API de OpenAI - Entendiendo la integración de GPT-4o-mini
Visión General del Cumplimiento Financiero con IA - Perspectivas de la industria sobre IA en finanzas
RegTech Explicado - Introducción a la tecnología regulatoria

🚀 Guía de Inicio Rápido

Requisitos Previos

Python 3.8+ (Descargar Python)
Clave API de OpenAI (Obtener Clave API)
Git (Instalar Git)

1. Clonar y Configurar

# Clone the repository
git clone https://github.com/your-username/regguard-mcp.git
cd regguard-mcp

# Create virtual environment (recommended)
python -m venv regguard-env
source regguard-env/bin/activate  # On Windows: regguard-env\Scripts\activate

# Install dependencies
pip install -r requirements.txt

2. Configurar la Clave API

Crea un archivo .env en la raíz del proyecto:

# Create .env file
echo 'OPENAI_API_KEY="your-openai-api-key-here"' > .env

Importante: ¡Nunca subas tu clave API real a GitHub!

3. Probar el Servidor

# Test server functionality
python test_server.py

# Test AI integration
python test_ai_client.py

# Run example usage
python example_usage.py

🔌 Cómo Usar el Servidor MCP de RegGuard

Opción 1: Integración con Claude Desktop (Recomendada)

Instalar Claude Desktop (Descargar aquí)
Configurar Ajustes de MCP:
- Abre los ajustes de Claude Desktop
- Navega a "Developer" > "MCP Servers"
- Añade la siguiente configuración:

{
  "mcpServers": {
    "regguard": {
      "command": "python",
      "args": ["-m", "src.regguard.server"],
      "cwd": "/full/path/to/regguard-mcp",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

Comenzar a Usar:

@regguard Please check this marketing copy for Singapore compliance:
"Our investment product guarantees 15% annual returns with zero risk!"

Opción 2: Integración con Cursor IDE

Instalar Cursor (Descargar aquí)
Configurar MCP en el Espacio de Trabajo: Añade a los ajustes de tu espacio de trabajo de Cursor:

{
  "mcp.servers": [
    {
      "name": "regguard",
      "command": ["python", "-m", "src.regguard.server"],
      "cwd": "./regguard-mcp"
    }
  ]
}

Usar en Cursor:

@regguard Analyze this financial ad for Hong Kong compliance violations

Opción 3: Integración Directa con Python

from regguard_client import RegGuardClient

# Initialize client
client = RegGuardClient()
client.start_server()

# Check compliance
result = client.check_compliance(
    html_content="<p>Guaranteed 20% returns!</p>",
    jurisdiction="sg"
)

print(f"Violations found: {len(result['violations'])}")

🛠️ Herramientas y Funciones Disponibles

1. `check_rule_violation` - Análisis de Cumplimiento con IA

Analiza contenido de marketing en busca de violaciones regulatorias en múltiples jurisdicciones.

Ejemplo de Uso:

@regguard Check this content for Singapore violations:
"Join our exclusive investment club! Guaranteed profits of 25% annually with zero risk to your capital. Limited time offer - only 48 hours remaining!"

La Respuesta Incluye:

Descripciones detalladas de violaciones
Niveles de severidad (Crítico, Alto, Medio, Bajo)
Fragmentos de contenido coincidentes resaltados
Referencias regulatorias
Recomendaciones accionables

2. `auto_insert_disclaimer` - Colocación Inteligente de Descargos

Inserta automáticamente descargos apropiados para cada jurisdicción en ubicaciones óptimas.

Ejemplo:

@regguard Add appropriate disclaimers for this Singapore investment ad:
<div>
  <h2>Investment Opportunity</h2>
  <p>High potential returns available.</p>
  <button>Invest Now</button>
</div>

3. `export_audit_trail` - Registros de Auditoría de Cumplimiento

Genera informes de auditoría completos para equipos de cumplimiento.

4. `health` - Estado del Sistema

Verifica la salud del servidor y el estado de las capacidades de IA.

5. `list_supported_markets` - Jurisdicciones Disponibles

Devuelve: ["sg", "hk", "ae", "in"]

📁 Estructura del Proyecto

regguard-mcp/
├── src/regguard/           # Core server code
│   ├── server.py          # Main MCP server
│   ├── rules_engine.py    # AI compliance engine
│   └── audit_writer.py    # Audit trail management
├── rules/                 # Jurisdiction-specific rules
│   ├── sg.yml            # Singapore (MAS)
│   ├── hk.yml            # Hong Kong (SFC)
│   ├── ae.yml            # UAE (DFSA)
│   └── in.yml            # India (SEBI)
├── audits/               # Compliance audit logs
├── tests/                # Test files
├── example_usage.py      # Usage examples
├── requirements.txt      # Python dependencies
└── README.md            # This file

🌍 Jurisdicciones Soportadas

Mercado	Regulador	Características Clave	Requisitos Especiales
Singapur (SG)	MAS	Detección de rendimientos garantizados, Verificaciones de divulgación de riesgos	Idioma inglés, Advertencias de riesgo claras
Hong Kong (HK)	SFC	Verificaciones de autorización SFC, Advertencias de productos complejos	Soporte de chino tradicional/simplificado
EAU (AE)	DFSA/SCA	Validación de licencias DFSA, Requisitos de calificación de riesgo	Cumplimiento bilingüe árabe/inglés
India (IN)	SEBI	Requisitos de medidor de riesgo, Reglas de respaldo de celebridades	Divulgaciones en idiomas locales

🔧 Pasos de Implementación para tu Proyecto

Paso 1: Configuración del Entorno

# 1. Clone this repository
git clone https://github.com/your-username/regguard-mcp.git

# 2. Navigate to project directory
cd regguard-mcp

# 3. Create Python virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

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

Paso 2: Configuración

# 1. Get OpenAI API key from https://platform.openai.com/api-keys
# 2. Create .env file
echo 'OPENAI_API_KEY="your-actual-api-key"' > .env

# 3. Test configuration
python test_server.py

Paso 3: Integración

Elige tu método de integración preferido:

Para Usuarios de Claude Desktop:

Configura los ajustes de MCP como se muestra arriba
Reinicia Claude Desktop
Usa los comandos @regguard

Para Usuarios de Cursor IDE:

Añade la configuración de MCP al espacio de trabajo
Reinicia Cursor
Usa @regguard en tu código

Para Integración Personalizada:

Usa los scripts de ejemplo proporcionados
Implementa comunicación JSON-RPC
Sigue la especificación del protocolo MCP

Paso 4: Personalización

# 1. Modify jurisdiction rules in rules/ directory
# 2. Add custom compliance patterns
# 3. Extend supported markets if needed
# 4. Customize disclaimer templates

🧪 Probando tu Configuración

Prueba de Funcionalidad Básica

python test_server.py

Prueba de Integración con IA

python test_ai_client.py

Demostración Completa de Funciones

python example_usage.py

Ejemplos de Pruebas Manuales

Prueba de Violación Crítica:

Content: "Guaranteed 25% returns with zero risk!"
Expected: Multiple critical violations detected

Prueba de Contenido Cumplidor:

Content: "Investment involves risk. Past performance is not indicative of future results."
Expected: No violations, compliance status PASS

📊 Entendiendo los Resultados

Niveles de Severidad de Violaciones

CRÍTICO: Infracciones regulatorias graves que requieren atención inmediata
ALTO: Problemas de cumplimiento importantes que deben abordarse
MEDIO: Preocupaciones moderadas que pueden necesitar revisión
BAJO: Problemas menores o recomendaciones de mejores prácticas

Funciones de Análisis de IA

Comprensión Contextual: Va más allá de la coincidencia de palabras clave
Conocimiento Regulatorio: Entrenado en reglas específicas de cada jurisdicción
Puntuación de Confianza: Confianza de la IA en cada detección de violación
Recomendaciones Accionables: Sugerencias específicas para correcciones

🤝 Contribuciones

¡Damos la bienvenida a contribuciones! Por favor:

Haz un fork del repositorio
Crea una rama de características (git checkout -b feature/amazing-feature)
Haz commit de tus cambios (git commit -m 'Add amazing feature')
Haz push a la rama (git push origin feature/amazing-feature)
Abre un Pull Request

📜 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

🆘 Soporte y Solución de Problemas

Problemas Comunes

"Clave API de OpenAI no encontrada"

Asegúrate de que el archivo .env exista con el OPENAI_API_KEY correcto
Verifica que tu clave API sea válida y tenga créditos

"El servidor no responde"

Verifica que las dependencias de Python estén instaladas
Comprueba que el puerto no esté en uso por otro proceso
Revisa los registros de errores en la terminal

"El análisis de IA falló"

Confirma que la clave API de OpenAI tenga créditos suficientes
Verifica la conexión a internet
Comprueba el estado del servicio de OpenAI

Obtener Ayuda

📚 Documentación: Revisa las guías detalladas en /docs
🐛 Problemas: Reporta errores a través de GitHub Issues
💬 Discusiones: Únete a nuestras Discusiones de GitHub para preguntas
📧 Contacto: Contacta para soporte empresarial

🚀 ¿Qué Sigue?

Soporte de jurisdicciones adicionales (UE, EE. UU., Canadá)
Panel de monitoreo de cumplimiento en tiempo real
Integración con más asistentes de IA
Soporte multilingüe mejorado
Análisis avanzado e informes

Construido con ❤️ para la comunidad de cumplimiento financiero

RegGuard ayuda a garantizar que tu contenido de marketing financiero cumpla con los estándares regulatorios en los mercados globales. Mantente en cumplimiento, mantente seguro.