Skip to main content
Glama
Sign In
gts-repo-guardian

gts-repo-guardian

by planetazuzu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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: MCP GitHub README Generator

⚡ 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.

Available Tools

6 tools
apply_improvementsB

Aplica las mejoras automáticamente basándose en el informe de review

Inputs: repo (required), owner (required), improvements (required).

clean_repositoryC

Limpia y estructura un repositorio automáticamente

Inputs: repo (required), owner (required).

generate_readmeB

Genera un README profesional automáticamente basado en el código del repo

Inputs: repo (required), owner (required), template.

review_all_repositoriesA

Revisa todos los repos públicos de un perfil GitHub

Inputs: username (required).

review_repositoryA

Analiza un repositorio GitHub y genera informe de calidad con puntuación 0-100

Inputs: repo (required), owner (required).

watch_repositoriesC

Monitoriza repos y alerta sobre problemas

Inputs: username (required), daysInactive.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation4/5

    Most tools are clearly distinct: review, generate README, clean, bulk review, apply improvements, and watch. The main overlap is between clean_repository and apply_improvements, both of which modify a repo, though their stated intents are different enough to be workable.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern, such as review_repository, generate_readme, and watch_repositories. The naming is predictable and makes the action of each tool immediately clear.

    Tool Count5/5

    Six tools is well within the ideal range for a focused repo management server. Each tool covers a distinct part of the repo guarding workflow without unnecessary bloat.

    Completeness4/5

    The surface covers core lifecycle needs: review, improve, clean, document, bulk review, and monitor repos. Missing pieces like rollback/revert or report retrieval are minor and can be worked around.

    Resources

    Related MCP Connectors

    Related MCP Servers