workspace-v1/core/mcp-servers/README.md

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

# 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

# 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

# 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

# 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:

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

@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

# Verificar SSH
ssh -T gitea-server

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

Dependencias faltantes

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

Variables de entorno

# 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