SME Library MCP

Un servidor MCP gratuito y de código abierto para crear, buscar y compartir perfiles de expertos en la materia que los agentes de IA pueden consultar. Cualquiera puede conectar su agente, recuperar expertos verificados de la biblioteca compartida, mantener expertos privados en su propio espacio de trabajo y aportar buenos perfiles mediante un pipeline de promoción moderado — o autoalojar toda la infraestructura.

Licenciado bajo la Licencia MIT. Las contribuciones son bienvenidas mediante issues y pull requests.

Se ejecuta en Vercel (Next.js + Streamable HTTP transport) con un backend de Supabase. ¿Nuevo por aquí? Lee la Guía del usuario — cómo funciona todo y la referencia completa de cada campo de un perfil SME y sus rangos de valores (también disponible en la aplicación en /guide). Consulta ARCHITECTURE.md para el diseño completo y la hoja de ruta, y docs/SME_MCP_Implementation_Checklist.pdf para el manual de despliegue paso a paso (regenerable desde docs/implementation-checklist.html).

Herramientas

Related MCP server: HiveMind

Configuración

1. Supabase

Crea un proyecto y, a continuación, aplica la migración:

supabase link --project-ref <ref>
supabase db push                    # applies supabase/migrations/*.sql
supabase functions deploy embed     # optional: enables semantic/hybrid search

La función edge embed ejecuta el modelo integrado gte-small. Es opcional: sin ella, la búsqueda pasa automáticamente a la búsqueda FTS por palabras clave.

2. Obtén una clave API

Autoservicio (recomendado): visita /dashboard, crea una cuenta (Supabase Auth) y genera una clave. El primer inicio de sesión crea automáticamente tu espacio de trabajo. Requiere que SUPABASE_ANON_KEY esté definida y que la autenticación por correo electrónico esté habilitada en el proyecto de Supabase.

Operador / CLI: para claves de administración o aprovisionamiento mediante scripts:

SUPABASE_URL=... SUPABASE_SERVICE_ROLE_KEY=... \
  node scripts/create-key.mjs --workspace "My Team"            # read,write key
  node scripts/create-key.mjs --workspace "Ops" --admin        # admin key

En cualquier caso, la clave en texto plano (sme_live_...) se muestra una sola vez; solo se almacena su hash SHA-256.

3. Despliegue en Vercel

vercel deploy

Configura las variables de entorno en el proyecto de Vercel: SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_ANON_KEY (habilita el panel), ANTHROPIC_API_KEY y CRON_SECRET (protege la tarea diaria /api/cron/maintenance que recalcula las puntuaciones de calidad, poda las ventanas de límite de tasa y rellena los embeddings). Define también NEXT_PUBLIC_BASE_URL con la URL canónica de tu sitio y ADMIN_EMAILS (separadas por comas) para inicializar el acceso de administración.

3b. Correo electrónico (confirmaciones y restablecimiento de contraseña)

Los correos de autenticación los envía Supabase, no esta aplicación. Si las nuevas cuentas no reciben correos de validación, se trata de un problema de configuración de Supabase — normalmente SMTP personalizado no configurado (el remitente incorporado está limitado a unos pocos por hora, solo para pruebas). En el panel de Supabase: configura Autenticación → Correos → Configuración de SMTP (Resend/Postmark/SendGrid/SES), habilita Confirmar correo en Proveedores → Correo electrónico y añade tu sitio + …/auth/callback a la lista de permitidos de Configuración de URL.

4. Conecta un cliente

claude mcp add --transport http sme-library \
  https://<deployment>/api/mcp \
  --header "Authorization: Bearer sme_live_..."

Funciona con Claude Code, conectores personalizados de claude.ai y cualquier cliente MCP Streamable-HTTP.

Desarrollo local

cp .env.example .env      # fill in Supabase + Anthropic
npm install
npm run dev               # HTTP server on :3000 (endpoint: /api/mcp)
SME_API_KEY=sme_live_... npm run stdio   # or stdio transport for local clients

Modelo de seguridad

• Las claves de API se almacenan con hash (SHA-256) y solo se pasan en la cabezera Authorization; la credencial nunca aparece en los argumentos de las herramientas ni en el contexto del modelo.

• Cada clave está asignada a un espacio de trabajo con los ámbitos (read, write, promote, admin) y un nivel de límite de tasa; los límites de ventana fija por clave se aplican en Postgres.

• Supabase RLS se habilita como denegación total en la base de Postgres todas las tablas como defensa en profundidad; solo el cliente de servicio-role del servidor puede leer o escribir.

• Todas las escrituras quedan en audit_log.