nexus-convergence-mcp

Servidor MCP que envuelve la Balanced Intelligence Convergence Pipeline.

Expone la tubería completa como 4 herramientas MCP utilizables por cualquier cliente compatible con MCP (Claude Code, Claude Desktop, etc.).

Herramientas

converge_query

Distribuye una consulta a múltiples LLM, ejecuta el consenso y devuelve un resultado estructurado.

{
  "query": "Is this treatment effective?",
  "models": ["gpt-4o", "claude-3-5-sonnet-20241022", "gemini-1.5-pro"],
  "policy_set": "hipaa"
}

Devuelve: run_id, agreement_score, stability, agreed_claims, disputed_claims, final_answer.

get_evidence_ladder

Devuelve la "Escalera de Evidencia" (Evidence Ladder) completa para una consulta: un registro de auditoría inmutable de cada paso de la tubería.

{ "query_id": "run-uuid" }

Devuelve: una lista ordenada de entradas desde QUERY → DECOMPOSE → MODEL_EXECUTE → CONSENSUS → VERIFY → CONCLUDE.

check_compliance

Verifica el contenido frente a políticas HIPAA/EU_AI_ACT/NIST/CUSTOM.

{
  "content": "Patient SSN is 123-45-6789",
  "categories": ["HIPAA"]
}

Devuelve: passed, blocked, violations, warnings, logs.

list_model_disagreements

Devuelve dónde divergieron los modelos: inversiones (contradicciones directas), afirmaciones disputadas, pares de baja similitud.

{ "query_id": "run-uuid" }

Devuelve: inversions, disputed_claims, low_similarity_pairs.

Configuración de MCP

Añadir a su configuración de MCP:

{
  "mcpServers": {
    "nexus-convergence": {
      "command": "npx",
      "args": ["-y", "@gonzih/nexus-convergence-mcp"],
      "env": {
        "CONVERGENCE_SERVICE_URL": "http://your-convergence-service:3000",
        "CONSENSUS_SERVICE_URL": "http://your-consensus-service:3001",
        "EVIDENCE_SERVICE_URL": "http://your-evidence-service:3002",
        "COMPLIANCE_SERVICE_URL": "http://your-compliance-service:3003",
        "NEXUS_API_KEY": "your-api-key"
      }
    }
  }
}

Entorno

CONVERGENCE_SERVICE_URL=http://localhost:3000
CONSENSUS_SERVICE_URL=http://localhost:3001
EVIDENCE_SERVICE_URL=http://localhost:3002
COMPLIANCE_SERVICE_URL=http://localhost:3003
NEXUS_API_KEY=your-api-key

Desarrollo

npm ci
npm run build
npm start
npm test