RegGuard

Verificação de conformidade regulatória com inteligência artificial para conteúdo de marketing financeiro em múltiplas jurisdições.

GitHub

Experimente este MCPPatrocinado

Documentação

RegGuard MCP Server 🛡️

Servidor de Conformidade de Marketing Financeiro Aprimorado por IA usando Model Context Protocol (MCP)

O RegGuard é um servidor MCP (Model Context Protocol) sofisticado que fornece verificação de conformidade regulatória impulsionada por IA para conteúdo de marketing financeiro. Ele aproveita o modelo GPT-4o-mini da OpenAI combinado com conhecimento regulatório específico de jurisdição para detectar violações em múltiplos mercados financeiros.

🎯 O Que o RegGuard Faz?

O RegGuard atua como um assistente de conformidade inteligente que:

🔍 Analisa Conteúdo de Marketing: Usa IA para examinar materiais de marketing financeiro em busca de violações regulatórias
🌍 Suporte Multi-Jurisdição: Abrange regulamentações de Singapura (SG), Hong Kong (HK), EAU (AE) e Índia (IN)
⚡ Verificação de Conformidade em Tempo Real: Integra-se perfeitamente com assistentes de IA como Claude e Cursor
📋 Inserção Automática de Avisos Legais: Posiciona inteligentemente os avisos regulatórios exigidos
📊 Geração de Trilha de Auditoria: Mantém registros à prova de adulteração de todas as verificações de conformidade
🎯 Análise Contextual de IA: Vai além da correspondência de padrões para compreender nuances regulatórias

🧠 Conceitos-Chave e Recursos Educacionais

Entendendo o MCP (Model Context Protocol)

MCP Official Documentation - Aprenda sobre o padrão aberto para conectar assistentes de IA a sistemas externos
MCP GitHub Repository - Especificação técnica e exemplos
Building MCP Servers - Anthropic Guide - Guia passo a passo para criar servidores MCP

Fundamentos de Conformidade Regulatória Financeira

MAS Guidelines on Fair Dealing (Singapore) - Regulamentações de marketing financeiro de Singapura
SFC Investment Advertisement Guidelines (Hong Kong) - Regras de marketing de valores mobiliários de Hong Kong
DFSA Conduct Rules (UAE) - Regulamentações de serviços financeiros de Dubai
SEBI Guidelines (India) - Regulamentações do Securities and Exchange Board of India

Tecnologia de Conformidade Impulsionada por IA

OpenAI API Documentation - Entendendo a integração com GPT-4o-mini
Financial AI Compliance Overview - Insights do setor sobre IA em finanças
RegTech Explained - Introdução à tecnologia regulatória

🚀 Guia de Início Rápido

Pré-requisitos

Python 3.8+ (Baixar Python)
Chave da API da OpenAI (Obter Chave da API)
Git (Instalar Git)

1. Clone e Configuração

# 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. Configure a Chave da API

Crie um arquivo .env na raiz do projeto:

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

Importante: Nunca envie sua chave de API real para o GitHub!

3. Teste o Servidor

# Test server functionality
python test_server.py

# Test AI integration
python test_ai_client.py

# Run example usage
python example_usage.py

🔌 Como Usar o Servidor MCP RegGuard

Opção 1: Integração com Claude Desktop (Recomendada)

Instale o Claude Desktop (Baixar aqui)
Configure as Configurações do MCP:
- Abra as configurações do Claude Desktop
- Navegue até "Developer" > "MCP Servers"
- Adicione a seguinte configuração:

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

Comece a Usar:

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

Opção 2: Integração com o IDE Cursor

Instale o Cursor (Baixar aqui)
Configure o MCP no Workspace: Adicione às configurações do seu workspace no Cursor:

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

Use no Cursor:

@regguard Analyze this financial ad for Hong Kong compliance violations

Opção 3: Integração Direta com 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'])}")

🛠️ Ferramentas e Recursos Disponíveis

1. `check_rule_violation` - Análise de Conformidade com IA

Analisa conteúdo de marketing em busca de violações regulatórias em múltiplas jurisdições.

Exemplo 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!"

A Resposta Inclui:

Descrições detalhadas de violações
Níveis de gravidade (Crítico, Alto, Médio, Baixo)
Destaques do conteúdo correspondente
Referências regulatórias
Recomendações acionáveis

2. `auto_insert_disclaimer` - Posicionamento Inteligente de Avisos Legais

Insere automaticamente avisos legais apropriados para a jurisdição em locais ideais.

Exemplo:

@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 Auditoria de Conformidade

Gera relatórios de auditoria abrangentes para equipes de conformidade.

4. `health` - Status do Sistema

Verifica a saúde do servidor e o status das capacidades de IA.

5. `list_supported_markets` - Jurisdições Disponíveis

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

📁 Estrutura do Projeto

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

🌍 Jurisdições Suportadas

Mercado	Regulador	Principais Recursos	Requisitos Especiais
Singapura (SG)	MAS	Detecção de retornos garantidos, Verificações de divulgação de riscos	Idioma inglês, Avisos claros de risco
Hong Kong (HK)	SFC	Verificações de autorização da SFC, Avisos de produtos complexos	Suporte a chinês tradicional/simplificado
EAU (AE)	DFSA/SCA	Validação de licenciamento DFSA, Requisitos de classificação de risco	Conformidade bilíngue árabe/inglês
Índia (IN)	SEBI	Requisitos de risk-o-meter, Regras de endosso de celebridades	Divulgações em idioma local

🔧 Etapas de Implementação para Seu Projeto

Etapa 1: Configuração do Ambiente

# 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

Etapa 2: Configuração

# 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

Etapa 3: Integração

Escolha seu método de integração preferido:

Para Usuários do Claude Desktop:

Configure as configurações do MCP conforme mostrado acima
Reinicie o Claude Desktop
Use os comandos @regguard

Para Usuários do IDE Cursor:

Adicione a configuração do MCP ao workspace
Reinicie o Cursor
Use @regguard no seu código

Para Integração Personalizada:

Use os scripts de exemplo fornecidos
Implemente a comunicação JSON-RPC
Siga a especificação do protocolo MCP

Etapa 4: Personalização

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

🧪 Testando Sua Configuração

Teste de Funcionalidade Básica

python test_server.py

Teste de Integração com IA

python test_ai_client.py

Demonstração Completa de Recursos

python example_usage.py

Exemplos de Teste Manual

Teste de Violação Crítica:

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

Teste de Conteúdo em Conformidade:

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

📊 Entendendo os Resultados

Níveis de Gravidade de Violações

CRÍTICO: Violações regulatórias graves que exigem atenção imediata
ALTO: Problemas de conformidade importantes que devem ser resolvidos
MÉDIO: Preocupações moderadas que podem precisar de revisão
BAIXO: Problemas menores ou recomendações de boas práticas

Recursos de Análise de IA

Compreensão Contextual: Vai além da correspondência de palavras-chave
Conhecimento Regulatório: Treinado em regras específicas de cada jurisdição
Pontuação de Confiança: Confiança da IA em cada detecção de violação
Recomendações Acionáveis: Sugestões específicas para correções

🤝 Contribuindo

Aceitamos contribuições! Por favor:

Faça um fork do repositório
Crie um branch de recurso (git checkout -b feature/amazing-feature)
Faça commit das suas alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

📜 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

🆘 Suporte e Solução de Problemas

Problemas Comuns

"Chave da API da OpenAI não encontrada"

Certifique-se de que o arquivo .env existe com o OPENAI_API_KEY correto
Verifique se sua chave de API é válida e possui créditos

"Servidor não está respondendo"

Verifique se as dependências do Python estão instaladas
Verifique se a porta não está em uso por outro processo
Revise os logs de erro no terminal

"Falha na análise de IA"

Confirme se a chave da API da OpenAI tem créditos suficientes
Verifique a conexão com a internet
Verifique o status do serviço da OpenAI

Obtendo Ajuda

📚 Documentação: Revise os guias detalhados em /docs
🐛 Issues: Reporte bugs pelo GitHub Issues
💬 Discussões: Participe das nossas Discussões no GitHub para perguntas
📧 Contato: Entre em contato para suporte empresarial

🚀 O Que Vem a Seguir?

Suporte a jurisdições adicionais (UE, EUA, Canadá)
Painel de monitoramento de conformidade em tempo real
Integração com mais assistentes de IA
Suporte multilíngue aprimorado
Análises avançadas e relatórios

Construído com ❤️ para a comunidade de conformidade financeira

O RegGuard ajuda a garantir que seu conteúdo de marketing financeiro atenda aos padrões regulatórios em mercados globais. Mantenha-se em conformidade, mantenha-se confiante.