Skip to main content
Glama
Modular MCP Server

Modular MCP Server

by satanas66

πŸš€ Servidor MCP Modular

Servidor MCP (Model Context Protocol) centralizado y modular diseΓ±ado para conectar modelos de lenguaje (LLMs) con recursos corporativos crΓ­ticos de forma segura, escalable y mantenible.

Su objetivo principal es eliminar silos de informaciΓ³n y permitir que agentes inteligentes puedan interactuar con:

  • Bases de datos MongoDB

  • Repositorios GitHub

  • Sistemas de archivos locales protegidos mediante sandbox


🎯 Características Principales

βœ… Arquitectura modular y desacoplada

βœ… IntegraciΓ³n nativa con el protocolo MCP

βœ… GestiΓ³n segura de repositorios GitHub

βœ… Acceso controlado a MongoDB

βœ… Sandbox dinΓ‘mico para protecciΓ³n del sistema de archivos

βœ… AuditorΓ­a y trazabilidad de acciones automatizadas

βœ… Compatible con Claude Desktop y MCP Inspector


πŸ—οΈ Arquitectura

El proyecto implementa una arquitectura hexagonal dividida en tres capas:

[ Cliente MCP / Claude ]
           β”‚
           β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Capa de AplicaciΓ³n (MCP Tools)       β”‚
β”‚ - mcp-server.js                      β”‚
β”‚ - database-tools.js                  β”‚
β”‚ - github-tools.js                    β”‚
β”‚ - file-system-tools.js               β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                β”‚
                β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Capa de Dominio (Services)           β”‚
β”‚ - database-service.js                β”‚
β”‚ - github-service.js                  β”‚
β”‚ - file-system-service.js             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                β”‚
                β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Capa de Infraestructura              β”‚
β”‚ - mongodb.js                         β”‚
β”‚ - github.js                          β”‚
β”‚ - file-system.js                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Capas

1. AplicaciΓ³n

Expone funcionalidades mediante MCP Tools, Resources y Prompts.

Responsabilidades:

  • DefiniciΓ³n de esquemas JSON

  • GestiΓ³n de handlers

  • ExposiciΓ³n de capacidades MCP

2. Dominio

Contiene la lΓ³gica de negocio:

  • OrquestaciΓ³n de procesos

  • Reglas de validaciΓ³n

  • PolΓ­ticas operativas

3. Infraestructura

Implementa la comunicaciΓ³n con sistemas externos:

  • MongoDB

  • GitHub API (Octokit)

  • Sistema de archivos local


πŸ”’ Seguridad

Related MCP server: MongoDB MCP Server

Sandbox DinΓ‘mico

El acceso al sistema de archivos estΓ‘ protegido mediante un sandbox configurable.

ProtecciΓ³n contra Path Traversal

Se utilizan:

path.resolve()
path.normalize()

para garantizar que ninguna operaciΓ³n pueda salir de los directorios autorizados.

Ejemplo bloqueado:

../../../../etc/passwd

Recursos Protegidos

Acceso denegado a:

.env
.git
node_modules

AuditorΓ­a

Todas las acciones automΓ‘ticas sobre GitHub incorporan la firma:

[TFM-AGENT]

permitiendo trazabilidad completa de cambios.


πŸ“‚ Estructura del Proyecto

tfm-mcp/
β”‚
β”œβ”€β”€ index.js
β”œβ”€β”€ pipeline.prompt
β”œβ”€β”€ resumen_tfm.txt
β”‚
β”œβ”€β”€ src/
β”‚   β”‚
β”‚   β”œβ”€β”€ application/
β”‚   β”‚   β”œβ”€β”€ mcp-server.js
β”‚   β”‚   └── tools/
β”‚   β”‚       β”œβ”€β”€ database-tools.js
β”‚   β”‚       β”œβ”€β”€ github-tools.js
β”‚   β”‚       └── file-system-tools.js
β”‚   β”‚
β”‚   β”œβ”€β”€ domain/
β”‚   β”‚   β”œβ”€β”€ database-service.js
β”‚   β”‚   β”œβ”€β”€ github-service.js
β”‚   β”‚   └── file-system-service.js
β”‚   β”‚
β”‚   └── infrastructure/
β”‚       β”œβ”€β”€ mongodb.js
β”‚       β”œβ”€β”€ github.js
β”‚       └── file-system.js
β”‚
└── .env

βš™οΈ Requisitos

  • Node.js 18+

  • MongoDB

  • Token de GitHub con permisos de lectura/escritura


πŸš€ InstalaciΓ³n

1. Clonar repositorio

git clone <URL_REPOSITORIO>
cd tfm-mcp

2. Instalar dependencias

npm install

3. Configurar variables de entorno

Crear archivo .env:

# MongoDB
MONGODB_URI=mongodb://127.0.0.1:27017/tu_base_datos

# GitHub
GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxx

# Directorio raΓ­z autorizado
USER_HOME=C:/tfm-mcp

# Carpetas permitidas dentro del sandbox
ALLOWED_PATHS=workspace,logs,auditoria

πŸ› οΈ Herramientas MCP Disponibles

πŸƒ Base de Datos (MongoDB)

Herramienta

DescripciΓ³n

listar_bases_de_datos

Lista todas las bases de datos

ver_colecciones

Muestra colecciones

crear_documento

Inserta documentos

contar_documentos

Cuenta registros

listar_documentos

Obtiene los ΓΊltimos documentos

actualizar_documento

Actualiza registros

eliminar_documento

Elimina registros


πŸ™ GitHub

Herramienta

DescripciΓ³n

ver_mis_repositorios

Lista repositorios del usuario

crear_repositorio

Crea repositorios privados

crear_rama_github

Genera ramas

crear_pull_request

Abre Pull Requests

subir_archivo_github

Crea o actualiza archivos


πŸ“‚ Sistema de Archivos

Herramienta

DescripciΓ³n

leer_archivo_local

Lee archivos autorizados

listar_archivos_proyecto

Explora directorios

clonar_proyecto_github

Clona repositorios

ejecutar_git_local

Ejecuta comandos Git permitidos


πŸ”„ IntegraciΓ³n con Claude Desktop

Agregar la siguiente configuraciΓ³n en:

claude_desktop_config.json
{
  "mcpServers": {
    "tfm-enterprise-agent": {
      "command": "node",
      "args": [
        "--env-file=C:\\tfm-mcp\\.env",
        "C:\\tfm-mcp\\index.js"
      ]
    }
  }
}

Ajusta las rutas segΓΊn la ubicaciΓ³n real del proyecto.


πŸ” DepuraciΓ³n

Para inspeccionar y probar el servidor MCP:

npx @modelcontextprotocol/inspector node index.js

Esto abrirΓ‘ la interfaz oficial de diagnΓ³stico MCP para validar herramientas, recursos y prompts.


πŸ“š Recursos MCP

El servidor expone capacidades MCP mediante:

Tools

Herramientas ejecutables por el agente.

Resources

Recursos de solo lectura como:

resumen://tfm-info

Prompts

Plantillas reutilizables para auditorΓ­a, anΓ‘lisis y automatizaciΓ³n.


πŸ‘₯ AutorΓ­a y Datos AcadΓ©micos πŸŽ“

  • Autor: Edwin Patricio ArΓ©valo Angulo

  • Correo: edwareang@alum.us.es

  • Proyecto: Trabajo Fin de MΓ‘ster (TFM)

  • Programa: MΓ‘ster en IngenierΓ­a de Software Cloud, Datos y GestiΓ³n TI

  • Tema: Estudio y Prueba de Concepto sobre el Model Context Protocol: EliminaciΓ³n de silos de informaciΓ³n, gobernanza y seguridad en agentes de IA

  • Convocatoria: 2025/2026

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables natural language querying of MongoDB data by transforming AI agent questions into MongoDB aggregations. Supports secure data separation, semantic vector search, and advanced lookup capabilities for database interactions.
      5,254 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact natively with MongoDB databases, including schema discovery, CRUD operations, aggregation pipelines, and index management via natural language.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables secure enterprise AI agents to access internal tools like GitHub, Gmail, Calendar, file systems, databases, and knowledge bases through the Model Context Protocol, with built-in security, audit, and observability.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects AI assistants to GitHub repositories, pull requests, issues, commits, and code search while enabling repository visibility controls, CI/CD monitoring, sandboxed local filesystem access, and code quality/security analysis.
      13
      1
      MIT