Skip to main content
Glama
ErnestoZeferinoDiaz

Gestion MCP Server

Gestion MCP Server

MCP (Model Context Protocol) server que expone la API REST del backend GestionIntegrantes como herramientas para clientes MCP (Claude Desktop, Cline, Continue, etc.).

Herramientas disponibles

Tool

Descripción

Auth requerida

login

Autentica con email/password y almacena el JWT

No

get_me

Obtiene la sesión del usuario autenticado

JWT

logout

Limpia el token JWT de la sesión

No

list_personas

Lista personas con paginación, búsqueda y ordenamiento

JWT

get_persona

Obtiene una persona por ID

JWT

create_persona

Crea una nueva persona

JWT (ADMIN, MANAGER)

update_persona

Actualiza una persona existente

JWT (ADMIN, MANAGER)

delete_persona

Elimina una persona por ID

JWT (ADMIN)

list_usuarios

Lista usuarios con filtros, paginación y ordenamiento

JWT (ADMIN, MANAGER)

get_usuario_by_email

Busca un usuario por email

JWT (ADMIN, MANAGER)

Related MCP server: agentforge

Modos de transporte

El servidor soporta dos modos de transporte según la variable MCP_TRANSPORT:

Modo

MCP_TRANSPORT

Puerto

Uso

stdio

stdio (default)

N/A

Local, comunicación estándar por stdin/stdout

StreamableHTTP

sse o http

MCP_PORT (default 3000)

Docker, acceso remoto vía HTTP

Uso local (stdio)

Requisitos

  • Node.js 20+

  • Backend corriendo en http://localhost:8080

cd mcp-server
npm install
npm run build

# Variables de entorno (opcional)
export BACKEND_URL=http://localhost:8080
export MCP_TRANSPORT=stdio

node dist/index.js

Configuración en Claude Desktop

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "gestion": {
      "command": "node",
      "args": ["Ruta\\a\\GestionIntegrantes\\mcp-server\\dist\\index.js"],
      "env": {
        "BACKEND_URL": "http://localhost:8080",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

macOS (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gestion": {
      "command": "node",
      "args": ["/ruta/a/GestionIntegrantes/mcp-server/dist/index.js"],
      "env": {
        "BACKEND_URL": "http://localhost:8080",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

Uso con Docker

Desarrollo

# Desde la raíz del proyecto GestionIntegrantes/
docker compose --env-file deploy/.env.dev -f deploy/docker-compose.dev.yml up -d --build

El MCP estará disponible en http://localhost:3001/mcp.

El código fuente se monta como volumen, los cambios se recargan automáticamente (tsx watch).

Producción

docker compose --env-file deploy/.env.prod -f deploy/docker-compose.yml up -d --build

El MCP estará disponible en http://localhost:3000/mcp.

Configuración de clientes MCP para Docker

Al usar Docker, el MCP se expone como HTTP. Usa el transporte streamableHttp:

{
  "mcpServers": {
    "gestion": {
      "url": "http://localhost:3000/mcp",
      "transport": "streamableHttp"
    }
  }
}

Para desarrollo, cambia el puerto a 3001:

{
  "mcpServers": {
    "gestion": {
      "url": "http://localhost:3001/mcp",
      "transport": "streamableHttp"
    }
  }
}

Variables de entorno

Variable

Default

Descripción

BACKEND_URL

http://localhost:8080

URL base de la API REST del backend

MCP_PORT

3000

Puerto HTTP cuando se usa transporte SSE

MCP_TRANSPORT

stdio

Modo de transporte: stdio o sse/http

Flujo de uso típico

  1. Login: Invocar login con email y password. El servidor almacena el JWT internamente.

  2. Operaciones: Usar cualquier herramienta que requiera auth (el JWT se envía automáticamente en el header Authorization).

  3. Logout: Invocar logout para limpiar la sesión.

Ejemplo de conversación con un LLM usando el MCP:

Usuario: Lista todas las personas registradas
→ El LLM invoca automáticamente list_personas con los parámetros adecuados

Usuario: Crea una persona llamada Juan Pérez
→ El LLM invoca create_persona con { nombre: "Juan", apellidoPaterno: "Pérez" }

Estructura del proyecto

mcp-server/
├── package.json
├── tsconfig.json
├── .env.example
├── .dockerignore
└── src/
    ├── index.ts              # Entry point, registro de tools, transporte
    ├── api-client.ts         # Cliente HTTP con interceptor JWT
    └── tools/
        ├── auth.tools.ts     # login, get_me, logout
        ├── personas.tools.ts # CRUD de personas
        └── usuarios.tools.ts # Listado y búsqueda de usuarios
Install Server
F
license - not found
A
quality
C
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.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Official Microsoft MCP Server to query Microsoft Entra data using natural language

  • MCP server exposing the Backtest360 engine API as tools for AI agents.

  • Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.

View all MCP Connectors

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/ErnestoZeferinoDiaz/HumanResourcesManagement-MCP'

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