# MCP Servers

**Version:** 1.0.0
**Fecha:** 2026-01-04
**Sistema:** NEXUS v3.4 + SIMCO

---

## Proposito

Esta carpeta contiene la infraestructura para MCP (Model Context Protocol) servers del workspace. Los MCP servers proporcionan herramientas especializadas para agentes de IA.

---

## Estructura

```
mcp-servers/
├── README.md                 # Este archivo
├── _registry.yml             # Registro central de MCP servers
│
├── internal/                 # MCP servers desarrollados internamente
│   ├── .gitkeep
│   ├── rag-knowledge/        # [REPO INDEPENDIENTE] Sistema RAG
│   └── scrum-taiga/          # [REPO INDEPENDIENTE] Integracion Taiga
│
├── external/                 # MCP servers de terceros
│   ├── .gitkeep
│   └── _sources.yml          # Fuentes confiables
│
└── templates/                # Templates para nuevos MCP
    └── TEMPLATE-MCP-INTERNO/
```

---

## Arquitectura: Repositorios Independientes

Los MCP servers internos son **repositorios independientes** (NO submodules):

| Caracteristica | Valor |
|----------------|-------|
| Versionado | Independiente del workspace |
| Dependencias | Propias (node_modules excluidos) |
| Desarrollo | Ciclo de vida propio |
| Clonacion | Manual despues de workspace |

### Por que NO son submodules?

1. **Flexibilidad:** Pueden actualizarse sin afectar workspace
2. **Desarrollo independiente:** Equipos pueden trabajar en paralelo
3. **Reutilizacion:** Pueden usarse en otros contextos
4. **Simplicidad:** Sin complejidad de submodules anidados

---

## MCP Servers Disponibles

### Internos (Desarrollo Propio)

| MCP Server | Descripcion | Prioridad | Estado |
|------------|-------------|-----------|--------|
| **rag-knowledge** | Sistema RAG como fuente de verdad | MAXIMA | Planificado |
| **scrum-taiga** | Integracion con Taiga SCRUM | ALTA | Planificado |

### Externos (Terceros)

Ver `external/_sources.yml` para fuentes confiables de MCP servers externos.

---

## Instalacion

### 1. Requisitos Previos

- workspace-v1 clonado
- SSH configurado para Gitea (ver `orchestration/referencias/REPOSITORY-STRUCTURE.md`)
- Node.js >= 18

### 2. Clonar MCP Servers

```bash
# Navegar a carpeta de MCP internos
cd /home/isem/workspace-v1/core/mcp-servers/internal

# Clonar RAG Knowledge Base (recomendado para desarrollo)
git clone git@gitea-server:rckrdmrd/mcp-rag-knowledge.git rag-knowledge

# Clonar SCRUM Taiga (opcional)
git clone git@gitea-server:rckrdmrd/mcp-scrum-taiga.git scrum-taiga
```

### 3. Instalar Dependencias

```bash
# RAG Knowledge
cd rag-knowledge
npm install
cp .env.example .env
# Configurar .env con credenciales

# SCRUM Taiga
cd ../scrum-taiga
npm install
cp .env.example .env
# Configurar .env con credenciales Taiga
```

### 4. Verificar Instalacion

```bash
# Desde workspace-v1
cd /home/isem/workspace-v1

# Verificar estructura
ls -la core/mcp-servers/internal/

# Verificar que MCP servers responden
cd core/mcp-servers/internal/rag-knowledge
npm run health-check
```

---

## Desarrollo de Nuevos MCP

### Usar Template

```bash
# Copiar template
cp -r templates/TEMPLATE-MCP-INTERNO nuevo-mcp-server

# Personalizar
cd nuevo-mcp-server
# Editar package.json, README.md, etc.
```

### Directivas a Seguir

| Directiva | Proposito |
|-----------|-----------|
| @SIMCO_MCP | Desarrollo de MCP servers |
| @SIMCO_MCP_IMPORT | Importacion de MCP externos |
| @SIMCO_RAG | Interaccion con sistema RAG |

### Registrar en _registry.yml

Despues de crear un nuevo MCP server, agregarlo a `_registry.yml`:

```yaml
mcp_servers:
  internal:
    nuevo-mcp:
      name: "Nombre del MCP"
      description: "Descripcion"
      status: "development"
      repository:
        url: "git@gitea-server:rckrdmrd/mcp-nuevo.git"
      # ...
```

---

## Perfiles de Agentes Relacionados

| Perfil | Responsabilidad |
|--------|-----------------|
| @PERFIL_MCP_ARCHITECT | Diseno e integracion de MCP |
| @PERFIL_MCP_DEVELOPER | Desarrollo de MCP internos |
| @PERFIL_MCP_INTEGRATOR | Importacion de MCP externos |
| @PERFIL_RAG_ENGINEER | Mantenimiento del RAG |

---

## Aliases Utiles

```yaml
@MCP_SERVERS: "core/mcp-servers/"
@MCP_REGISTRY: "core/mcp-servers/_registry.yml"
@MCP_RAG: "core/mcp-servers/internal/rag-knowledge/"
@MCP_TAIGA: "core/mcp-servers/internal/scrum-taiga/"
```

---

## Troubleshooting

### MCP server no clonado

```bash
# Verificar SSH
ssh -T gitea-server

# Si falla, verificar ~/.ssh/config
cat ~/.ssh/config | grep gitea
```

### Dependencias faltantes

```bash
# Reinstalar
cd core/mcp-servers/internal/rag-knowledge
rm -rf node_modules
npm install
```

### Variables de entorno

```bash
# Verificar .env existe
ls -la .env

# Verificar variables requeridas
cat .env.example
```

---

## Referencias

- `_registry.yml` - Registro completo de MCP servers
- `orchestration/directivas/simco/SIMCO-MCP.md` - Directiva de desarrollo
- `orchestration/referencias/REPOSITORY-STRUCTURE.md` - Estructura de repos

---

**Mantenido por:** @PERFIL_MCP_ARCHITECT
**Sistema:** NEXUS v3.4 + SIMCO