Skip to main content
Glama

gts-repo-guardian 🛡️

MCP (Model Context Protocol) para gestión y revisión automática de repositorios GitHub

npm version License


📋 Descripción

gts-repo-guardian es un servidor MCP que automatiza la gestión de calidad de repositorios GitHub. Diseñado para mantener el estándar de documentación en los proyectos de @planetazuzu y GTS SOFTWARE.

Related MCP server: GitHub PR Review MCP Server

⚡ Características

Herramientas Disponibles

Herramienta

Descripción

review_repository

Analiza un repo y genera informe de calidad (0-100)

generate_readme

Genera README profesional automáticamente

clean_repository

Limpia y estructura el repositorio

review_all_repositories

Revisión masiva de todos los repos de un usuario

apply_improvements

Aplica mejoras automáticamente

watch_repositories

Monitoriza repos y alerta sobre problemas

🚀 Instalación

git clone https://github.com/PlanetaZero/gts-repo-guardian.git
cd gts-repo-guardian
npm install
npm run build

⚙️ Configuración

  1. Copia .env.example a .env:

cp .env.example .env
  1. Genera un token de GitHub en: https://github.com/settings/tokens

  2. Asigna el token en .env:

GITHUB_TOKEN=tu_token_aqui

🔧 Uso con OpenCode

Añade a tu configuración de OpenCode:

{
  "mcpServers": {
    "gts-repo-guardian": {
      "command": "node",
      "args": ["/ruta/a/gts-repo-guardian/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "tu_token_aqui"
      }
    }
  }
}

🔧 Uso con Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gts-repo-guardian": {
      "command": "node",
      "args": ["/ruta/a/gts-repo-guardian/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "tu_token_aqui"
      }
    }
  }
}

📊 Sistema de Puntuación

Puntuación

Color

Significado

80-100

🟢 Verde

Excelente

50-79

🟡 Amarillo

Necesita mejoras

0-49

🔴 Rojo

Necesita trabajo urgente

Reglas de Calidad

  • README.md existe y tiene >200 palabras: 30 pts

  • Repo tiene descripción en GitHub: 15 pts

  • Repo tiene al menos 3 topics: 10 pts

  • Licencia presente: 10 pts

  • .gitignore apropiado al stack: 10 pts

  • package.json con nombre y descripción: 10 pts

  • Carpetas organizadas correctamente: 10 pts

  • .env.example presente si hay variables: 5 pts

📁 Estructura del Proyecto

gts-repo-guardian/
├── src/
│   ├── index.ts              # Servidor MCP principal
│   ├── tools/
│   │   ├── review.ts         # Revisión de repos
│   │   ├── readme.ts          # Generación de READMEs
│   │   ├── clean.ts           # Limpieza y estructura
│   │   ├── batch.ts           # Revisión masiva
│   │   ├── improve.ts         # Aplicar mejoras
│   │   └── monitor.ts         # Monitorización continua
│   ├── templates/
│   │   ├── readme-sanitario.md
│   │   ├── readme-tech.md
│   │   └── readme-lab.md
│   └── config/
│       ├── rules.ts          # Reglas de calidad
│       └── profiles.ts       # Configuración de perfiles
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

👤 Autor

Javier Fernández · @planet://github.com/azuzu Técnico de Emergencias Sanitarias · +25 años · La Rioja, España GTS SOFTWARE

LinkedIn GitHub


📄 Licencia

MIT License - ver LICENSE para más detalles.

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/planetazuzu/gts-repo-guardian'

If you have feedback or need assistance with the MCP directory API, please join our Discord server