Skip to content

Colección de servidores MCP para automatización y administración con Claude Code

Notifications You must be signed in to change notification settings

alex-v08/server-mcp

Repository files navigation

🚀 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


[!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.

About

Colección de servidores MCP para automatización y administración con Claude Code

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published