Modular MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π 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/passwdRecursos Protegidos
Acceso denegado a:
.env
.git
node_modulesAuditorΓ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-mcp2. Instalar dependencias
npm install3. 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.jsEsto 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-infoPrompts
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β¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Git-backed platform for skills, tools, and context for AI agents
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Your company's brain for AI agents. Cited, permission-aware knowledge across every system.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact natively with MongoDB databases, including schema discovery, CRUD operations, aggregation pipelines, and index management via natural language.MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseAqualityDmaintenanceConnects 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.131MIT