workspace-v1/core/mcp-servers/_registry.yml

# MCP Servers Registry
# ====================
# Registro central de todos los MCP servers del workspace
#
# Version: 1.0.0
# Fecha: 2026-01-04
# Sistema: NEXUS v3.4 + SIMCO

version: "1.0.0"
last_updated: "2026-01-04"
maintainer: "@PERFIL_MCP_ARCHITECT"

# ============================================================================
# MCP SERVERS INTERNOS
# ============================================================================
# Desarrollados internamente para necesidades especificas del workspace
# Cada uno es un repositorio independiente que se clona manualmente

mcp_servers:
  internal:
    # -------------------------------------------------------------------------
    # RAG Knowledge Base - PRIORIDAD MAXIMA
    # -------------------------------------------------------------------------
    rag-knowledge:
      name: "RAG Knowledge Base"
      description: |
        Sistema RAG (Retrieval-Augmented Generation) como fuente de verdad
        del workspace. Proporciona busqueda semantica sobre documentacion,
        directivas, perfiles y codigo.        
      status: "planned"
      priority: "maxima"

      repository:
        type: "gitea"
        url: "git@gitea-server:rckrdmrd/mcp-rag-knowledge.git"
        https: "http://72.60.226.4:3000/rckrdmrd/mcp-rag-knowledge"

      clone_path: "core/mcp-servers/internal/rag-knowledge"

      dependencies:
        runtime:
          - "Node.js >= 18"
          - "TypeScript >= 5.0"
        database:
          - "PostgreSQL >= 15"
          - "pgvector extension"
        external_apis:
          - "OpenAI API (embeddings)"

      tools_provided:
        - rag_query_context
        - rag_get_directive
        - rag_get_agent_profile
        - rag_trace_reference
        - rag_get_relations
        - rag_find_code
        - rag_explain_impact
        - rag_index_document
        - rag_sync_category
        - rag_get_sync_status
        - rag_validate_coverage
        - rag_report_feedback

      documentation:
        architecture: "docs/ARCHITECTURE.md"
        deployment: "docs/DEPLOYMENT.md"
        usage: "docs/USAGE.md"
        tools_spec: "docs/MCP-TOOLS-SPEC.md"

    # -------------------------------------------------------------------------
    # SCRUM Taiga Integration - PRIORIDAD ALTA
    # -------------------------------------------------------------------------
    scrum-taiga:
      name: "SCRUM Taiga Integration"
      description: |
        Integracion con Taiga para gestion de proyectos SCRUM.
        Permite sincronizar EPICs, User Stories y Tasks entre
        el workspace y Taiga.        
      status: "planned"
      priority: "alta"

      repository:
        type: "gitea"
        url: "git@gitea-server:rckrdmrd/mcp-scrum-taiga.git"
        https: "http://72.60.226.4:3000/rckrdmrd/mcp-scrum-taiga"

      clone_path: "core/mcp-servers/internal/scrum-taiga"

      dependencies:
        runtime:
          - "Node.js >= 18"
          - "TypeScript >= 5.0"
        external_apis:
          - "Taiga API"

      tools_provided:
        - taiga_get_project
        - taiga_list_epics
        - taiga_create_epic
        - taiga_list_user_stories
        - taiga_create_user_story
        - taiga_list_tasks
        - taiga_create_task
        - taiga_update_status
        - taiga_sync_sprint

      documentation:
        architecture: "docs/ARCHITECTURE.md"
        deployment: "docs/DEPLOYMENT.md"
        usage: "docs/USAGE.md"

# ============================================================================
# MCP SERVERS EXTERNOS
# ============================================================================
# MCP servers de terceros evaluados y aprobados para uso

  external:
    # Lista de MCP servers externos pendientes de evaluacion
    pending_evaluation: []

    # MCP servers externos aprobados
    approved: []

    # Fuentes confiables para buscar MCP servers
    trusted_sources:
      - name: "Anthropic Official"
        url: "https://github.com/anthropics"
        priority: 1
      - name: "MCP Community"
        url: "https://github.com/modelcontextprotocol"
        priority: 2

# ============================================================================
# INSTRUCCIONES DE CLONACION
# ============================================================================

clone_instructions: |
  # Despues de clonar workspace-v1, clonar los MCP servers necesarios:

  # 1. Navegar a la carpeta de MCP internos
  cd /home/isem/workspace-v1/core/mcp-servers/internal

  # 2. Clonar RAG Knowledge Base (recomendado)
  git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge
  cd rag-knowledge && npm install && cd ..

  # 3. Clonar SCRUM Taiga (opcional)
  git clone git@gitea-server:rckrdmrd/mcp-scrum-taiga.git scrum-taiga
  cd scrum-taiga && npm install && cd ..

  # 4. Verificar instalacion
  ls -la  

# ============================================================================
# VALIDACION
# ============================================================================

validation:
  required_for_development:
    - rag-knowledge
  optional:
    - scrum-taiga

  check_command: |
    # Verificar que MCP servers estan clonados
    for mcp in rag-knowledge scrum-taiga; do
      if [ -d "core/mcp-servers/internal/$mcp" ]; then
        echo "OK: $mcp"
      else
        echo "MISSING: $mcp (clone con: git clone git@gitea-server:rckrdmrd/mcp-$mcp.git)"
      fi
    done