🚀 MCP Servers Collection

Colección de servidores MCP (Model Context Protocol) para Claude Code

📋 Servidores Disponibles

🔐 SSH MCP Server

Ubicación: ssh-mcp-server/ Estado: ✅ Completo Descripción: Servidor MCP para administración remota SSH con autenticación segura

Características:

• 7 herramientas SSH seguras
• Sistema de auditoría completo
• 5 prompts de administración guiada
• 4 recursos informativos
• Capa de seguridad robusta

Documentación: SSH MCP Server Docs

---

🎯 Estructura del Repositorio

mcp-server/
├── ssh-mcp-server/           # Servidor SSH MCP
│   ├── src/                  # Código fuente
│   ├── docs/                 # Documentación Obsidian
│   ├── dist/                 # Código compilado
│   └── README.md            # Documentación específica
├── [future-mcp-server]/     # Próximos servidores MCP
├── docs/                    # Documentación general
├── scripts/                 # Scripts de utilidad
└── README.md               # Este archivo

🛠️ Desarrollo de Nuevos Servidores MCP

Template Base

Cada nuevo servidor MCP debe seguir esta estructura:

[nombre]-mcp-server/
├── src/
│   ├── index.ts            # Servidor principal
│   ├── tools/              # Herramientas MCP
│   ├── resources/          # Recursos informativos
│   ├── prompts/            # Prompts guiados
│   ├── utils/              # Utilidades
│   └── types/              # Definiciones TypeScript
├── docs/                   # Documentación Obsidian
│   ├── 🏠 [Nombre] - Inicio.md
│   ├── 📦 Instalación.md
│   ├── 🛠️ Herramientas.md
│   └── [otras páginas].md
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

Estándares de Desarrollo

Naming Convention

• Servidores: [dominio]-mcp-server (ej: ssh-mcp-server, docker-mcp-server)
• Herramientas: [dominio]_[accion] (ej: ssh_connect, docker_run)
• Recursos: [dominio]://[recurso] (ej: ssh://connections)
• Prompts: [dominio]_[proposito] (ej: ssh_health_check)

Tecnologías Base

• Runtime: Node.js 18+
• Lenguaje: TypeScript con strict mode
• Framework: @modelcontextprotocol/sdk
• Validación: Zod para schemas
• Build: tsc para compilación

Características Requeridas

• ✅ Seguridad: Validación de inputs y sanitización
• ✅ Auditoría: Logging de todas las operaciones
• ✅ Documentación: Docs completas en Obsidian
• ✅ Testing: Tests unitarios y de integración
• ✅ TypeScript: Tipado estricto
• ✅ Error Handling: Manejo robusto de errores

📊 Ideas para Futuros Servidores MCP

🐳 Docker MCP Server

• Gestión de contenedores Docker
• Monitoreo de servicios
• Logs y métricas
• Orquestación básica

🌐 AWS MCP Server

• Gestión de instancias EC2
• Monitoreo de CloudWatch
• Gestión de S3
• Administración de RDS

🔄 CI/CD MCP Server

• Integración con GitHub Actions
• Gestión de pipelines
• Deployment automation
• Monitoreo de builds

📊 Monitoring MCP Server

• Integración con Prometheus
• Dashboards de Grafana
• Alertas automatizadas
• Métricas personalizadas

🗄️ Database MCP Server

• Administración MySQL/PostgreSQL
• Backups automatizados
• Monitoreo de performance
• Consultas seguras

🚀 Setup del Repositorio

1. Crear Repositorio GitHub

# Crear repositorio privado en GitHub
gh repo create mcp-server --private --description "Colección de servidores MCP para Claude Code"

# Clonar e inicializar
git clone https://github.com/[tu-usuario]/mcp-server.git
cd mcp-server

2. Configurar Estructura Base

# Copiar contenido actual
cp -r /mnt/c/Users/Alexv/workspace/mcp-server/* ./

# Commit inicial
git add .
git commit -m "🚀 Inicializar repositorio MCP Servers

- SSH MCP Server completo con documentación
- Estructura base para futuros servidores
- Documentación en Obsidian
- Scripts de desarrollo

🤖 Generated with Claude Code"

git push origin main

3. Configurar Branch Protection

# Proteger rama main (opcional)
gh api repos/:owner/:repo/branches/main/protection \
  --method PUT \
  --field required_status_checks='{"strict":true,"contexts":[]}' \
  --field enforce_admins=true \
  --field required_pull_request_reviews='{"required_approving_review_count":1}' \
  --field restrictions=null

📝 Workflow de Desarrollo

Para Nuevos Servidores MCP

1. Crear Branch:

   git checkout -b feature/[nombre]-mcp-server
   

2. Desarrollar Servidor:

   • Seguir estructura template
   • Implementar herramientas, recursos y prompts
   • Crear documentación Obsidian
   • Escribir tests

3. Documentar:

   • README específico del servidor
   • Documentación Obsidian completa
   • Ejemplos de uso
   • Guías de instalación

4. Commit y Push:

   git add .
   git commit -m "✨ Añadir [Nombre] MCP Server
   
   - [x] Herramientas implementadas
   - [x] Sistema de seguridad
   - [x] Documentación completa
   - [x] Tests unitarios
   
   🤖 Generated with Claude Code"
   
   git push origin feature/[nombre]-mcp-server
   

5. Pull Request:

   gh pr create --title "✨ [Nombre] MCP Server" \
     --body "Nuevo servidor MCP para [propósito]"
   

Para Updates

git checkout main
git pull origin main
git checkout -b update/[servidor]-[feature]
# ... realizar cambios ...
git commit -m "🔧 Actualizar [servidor]: [descripción]"
git push origin update/[servidor]-[feature]
gh pr create

🔧 Scripts de Utilidad

Script de Nuevo Servidor

# Crear en scripts/new-server.sh
./scripts/new-server.sh docker-mcp-server "Docker Management Server"

Script de Build All

# Compilar todos los servidores
./scripts/build-all.sh

Script de Test All

# Ejecutar tests de todos los servidores
./scripts/test-all.sh

📊 Métricas del Proyecto

• Servidores MCP: 1 (SSH)
• Herramientas Totales: 7
• Recursos Totales: 4
• Prompts Totales: 5
• Líneas de Código: ~2,000
• Cobertura Tests: TBD

🤝 Contribución

1. Fork del repositorio
2. Crear branch feature
3. Seguir estándares establecidos
4. Incluir documentación completa
5. Enviar Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT. Ver LICENSE para detalles.

🔗 Enlaces Útiles

• Model Context Protocol
• Claude Code Documentation
• MCP SDK GitHub

---

[!info] Repositorio Activo Este repositorio se actualiza constantemente con nuevos servidores MCP. Cada servidor incluye documentación completa en Obsidian y sigue los estándares establecidos.