Introducción a AnythingMCP

¿Qué es AnythingMCP?

AnythingMCP es un gateway de código abierto que convierte tus APIs REST, SOAP, GraphQL y bases de datos en servidores MCP (Modelo de Protocolo de Contexto). Una vez conectado, puedes interactuar con tus sistemas a través de agentes de IA como Claude, ChatGPT, Copilot o cualquier cliente compatible con MCP.

Requisitos Previos

• Docker y Docker Compose — Instalar Docker
• Git — para clonar el repositorio
• Una terminal — bash en macOS o Linux

Para desarrollo local sin Docker (opcional):

• Node.js 22+
• npm

Inicio Rápido

1. Clona el Repositorio

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp

2. Ejecuta el Script de Configuración

bash setup.sh

El asistente interactivo te guiará a través de la configuración completa:

Paso 1 — Modo de Despliegue
Elige entre Docker (recomendado para producción) o desarrollo local.

Paso 2 — Dominio y Puertos
Introduce tu nombre de host. Para uso local, mantén el valor predeterminado localhost. Para producción, introduce tu dominio (por ejemplo, mcp.ejemplo.com) y el script configurará Caddy como un proxy inverso con SSL automático de Let's Encrypt.

Paso 3 — Secretos
Todas las credenciales de seguridad se generan automáticamente:

• Secreto JWT para autenticación
• Clave de cifrado para datos sensibles
• Contraseña de la base de datos
• Secreto de NextAuth

Paso 4 — Autenticación MCP
Elige cómo los agentes de IA se autentican con tu punto final MCP:

• OAuth 2.0 (recomendado)
• API Key / Bearer Token (legado)
• Ambos (OAuth + retroceso legado)
• Ninguno (solo desarrollo)

Paso 5 — Correo Electrónico (Opcional)
Configura SMTP para verificación de usuarios, invitaciones y restablecimiento de contraseña.

Paso 6 — Redis (Opcional)
Habilita Redis para limitación de tasa y almacenamiento en caché de respuestas.

El script genera el archivo .env, configura Docker Compose y arranca todos los servicios automáticamente.

3. Abre el Panel de Control

Una vez completada la configuración, abre el panel de control:

• Local: http://localhost:3000
• Con dominio: https://mcp.ejemplo.com

Registra tu cuenta de administrador — el primer usuario en registrarse se convierte en el administrador.

Conecta tu Primera API

1. Inicia sesión en el panel de control
2. Haz clic en Crear Conector
3. Elige tu tipo de conector (REST, SOAP, GraphQL o Base de Datos)
4. Configura la conexión (importa la especificación OpenAPI, WSDL o introduce las credenciales de la base de datos)
5. Guarda y activa

Tu punto final MCP está listo en:

http://localhost:4000/mcp

Conecta un Agente de IA

Añade tu servidor MCP a cualquier cliente de IA compatible. Ejemplo para Claude Desktop (o añade la URL de tu servidor directamente en Claude.ai → Conectores):

{
  "mcpServers": {
    "my-server": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Arquitectura

AnythingMCP se ejecuta como un único contenedor con dos servicios:

Servicios adicionales:

• PostgreSQL 17 — almacena conectores, usuarios y configuración
• Caddy (opcional) — proxy inverso con SSL automático
• Redis (opcional) — limitación de tasa y almacenamiento en caché de respuestas

Comandos Comunes

# Ver logs
docker compose logs -f

# Reiniciar servicios
docker compose restart

# Detener servicios
docker compose down

# Actualizar a la última versión
git pull && docker compose up -d --build

Próximos Pasos

• ¿Qué es MCP? — Comprende el Modelo de Protocolo de Contexto
• REST API a MCP — Conecta tu primera API REST
• Base de Datos a MCP — Conecta bases de datos directamente
• Desplegar en Hetzner — Despliegue en producción con SSL
• Desplegar en AWS — Desplegar en EC2