cb4c0681d3
New projects created: - michangarrito (marketplace mobile) - template-saas (SaaS template) - clinica-dental (dental ERP) - clinica-veterinaria (veterinary ERP) Architecture updates: - Move catalog from core/ to shared/ - Add MCP servers structure and templates - Add git management scripts - Update SUBREPOSITORIOS.md with 15 new repos - Update .gitignore for new projects Repository infrastructure: - 4 main repositories - 11 subrepositorios - Gitea remotes configured 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
229 lines
5.0 KiB
Markdown
229 lines
5.0 KiB
Markdown
# 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
|