mcp-factory

Monorepo fábrica para crear MCP (Model Context Protocol) servers de forma ágil con FastMCP.

Estructura

mcp-factory/
├── _shared/        # Utilidades compartidas (config, logging, HTTP, DB, auth)
├── _templates/     # Plantillas para generar nuevos MCPs (basic, api, db)
├── _scripts/       # Automatización (crear, testear, instalar MCPs)
├── _configs/       # Configuraciones compartidas (ruff, env base)
└── servers/        # MCPs generados viven aquí

Requisitos

• Python 3.10+
• uv (gestor de paquetes)

Crear un nuevo MCP

# MCP básico
python _scripts/create_mcp.py --name mi-mcp --template basic

# MCP que consume APIs externas
python _scripts/create_mcp.py --name mi-api --template api

# MCP con acceso a base de datos
python _scripts/create_mcp.py --name mi-db --template db

Testear un MCP

# Abre el MCP Inspector en el navegador
python _scripts/test_mcp.py --name mi-mcp

Instalar un MCP en VS Code o Claude Desktop

python _scripts/install_mcp.py --name mi-mcp --target vscode
python _scripts/install_mcp.py --name mi-mcp --target claude

Templates disponibles

Template	Descripción	Dependencias extra
basic	MCP minimalista con un tool de ejemplo	—
api	MCP con cliente HTTP async preconfigurado	httpx
db	MCP con conexión async a base de datos	asyncpg / motor

Utilidades compartidas (_shared/)

Cada MCP generado puede importar estas utilidades:

• config — Carga de .env y configuración base
• logging — Logger estandarizado para MCPs
• http_client — Cliente HTTP async con defaults razonables
• db — Pool de conexiones async (PostgreSQL, MongoDB)
• auth — Helpers de autenticación (API keys, headers)

Contribuir

¿Quieres colaborar? Lee la Guía de Contribución y nuestro Código de Conducta.

Licencia

Este proyecto está bajo la licencia MIT.