genai-solutions-mcp

Un servidor MCP que expone una base de datos curada de herramientas de IA generativa — 1,197 registros que he mantenido en Notion desde 2023 — como cuatro herramientas que un asistente de IA puede consultar directamente.

En lugar de preguntar a un modelo qué herramientas de IA existen y obtener una respuesta plausible pero desactualizada, le pides que busque en un conjunto de datos que tiene una persona detrás.

> Which open-source tools in here run locally and have a CLI?
> Compare Firecrawl and the other scraping options.

Instalación

npm install
npm run build
npm start

Sin clave API, sin red, sin base de datos. El conjunto de datos se incluye con el repositorio.

Regístrelo con un cliente MCP (Claude Desktop se muestra aquí):

{
  "mcpServers": {
    "genai-solutions": {
      "command": "node",
      "args": ["/absolute/path/to/genai-solutions-mcp/dist/src/index.js"]
    }
  }
}

Related MCP server: disvr

Herramientas

Decisiones de diseño

Una instantánea comprometida, no un proxy en vivo de Notion. El diseño obvio es llamar a la API de Notion en cada llamada de herramienta. También es el que hace que el repositorio sea inútil para todos excepto para mí: necesitarías mi token y mi base de datos. En su lugar, scripts/sync-notion.ts exporta Notion a data/solutions.json, que está versionado aquí, y el servidor solo lee ese archivo. La compensación es la frescura — los datos están tan actualizados como la última sincronización — frente a un servidor que cualquiera puede clonar y ejecutar en quince segundos, sin credenciales, sin dependencia de red en el momento de la llamada y sin límite de tasa. Los datos subyacentes cambian como máximo semanalmente, por lo que la frescura es lo más barato de sacrificar.

Búsqueda de subcadenas, no embeddings. ~1,100 registros es un escaneo lineal de submilisegundos. Un índice vectorial agregaría un paso de embedding a la sincronización, una dependencia de modelo, resultados no deterministas y un índice que mantener coherente con la instantánea — a cambio de recuperación semántica en un corpus donde las consultas útiles son principalmente nombres y categorías. Si el conjunto de datos crece un orden de magnitud o los resúmenes se alargan, esto es lo primero que se debe revisitar.

La búsqueda devuelve una proyección, no registros completos. search_solutions devuelve solo id, nombre, tipo y url. Devolver registros completos para una consulta de 20 resultados gastaría una gran cantidad del contexto del agente en campos que normalmente no necesita; get_solution está ahí para cuando sí lo hace.

Una lista blanca de propiedades en la sincronización, no una lista negra. La base de datos de Notion contiene estado interno del flujo de trabajo y archivos adjuntos que no deberían ser públicos. scripts/sync-notion.ts nombra las propiedades que exporta, por lo que agregar una columna privada en Notion más tarde no puede filtrarla aquí silenciosamente.

Limitaciones conocidas

• El Type de Notion es una selección única, por lo que cada herramienta tiene exactamente una categoría incluso cuando dos encajarían.

• Los valores de categoría fueron ingresados a mano durante tres años y son dispares; la sincronización combina duplicados de mayúsculas y minúsculas pero no fusiona casi sinónimos.

• Sin clasificación de relevancia más allá de la coincidencia de subcadenas ponderada por campo.

• El etiquetado de atributos es dispar. Local y Open Source se aplicaron en diferentes épocas con diferentes hábitos, y se superponen en solo un registro aunque muchas herramientas califican para ambos. Los filtros son honestos sobre lo que está etiquetado, no sobre lo que es verdadero — una propiedad que este conjunto de datos comparte con la mayoría de las bases de datos internas reales.

• La resolución de Node depende del entorno anfitrión. Se observó que el servidor se inicia bajo dos instalaciones diferentes de Node en la misma máquina dependiendo del contexto de lanzamiento. Fije la ruta del runtime en su configuración del cliente si eso le importa.

Sincronización (solo para mantenedor)

NOTION_TOKEN=… NOTION_DATABASE_ID=… npm run sync
git diff data/solutions.json   # read it before committing

Licencia

MIT