NYCfoodie

npx add-mcp 'https://nycfoodie-production.up.railway.app/mcp'

NYCfoodie

La capa de datos para el gusto gastronómico: recomendaciones de restaurantes estructuradas y editoriales servidas a agentes de IA a través de MCP. No es otro raspador de reseñas: guías y reseñas curadas normalizadas en un solo esquema, consultable mediante herramientas.

Ciudad del MVP: Nueva York. La ciudad es un parámetro en todas partes; nada específico de Nueva York está codificado.

Úsalo

Endpoint alojado (HTTP Streamable): https://nycfoodie-production.up.railway.app/mcp

• Cursor — instalación en un clic
• Claude Code — claude mcp add --transport http nycfoodie https://nycfoodie-production.up.railway.app/mcp
• Windsurf / Cline / Roo Code / Zed / VS Code — añádelo a tu configuración de MCP:

{
  "mcpServers": {
    "nycfoodie": {
      "url": "https://nycfoodie-production.up.railway.app/mcp"
    }
  }
}

• Claude (app) — Configuración → Conectores → Añadir conector personalizado → pega la URL.
• Cualquier cliente MCP — añade la URL anterior como servidor remoto (HTTP Streamable). Sin autenticación, sin instalación.

Herramientas

search_restaurants · get_restaurant · compare_restaurants · find_guides · find_similar · guide_consensus · top_rated · submit_feedback

Estructura

• db/ — almacenamiento SQLite (better-sqlite3) con migraciones SQL numeradas escritas en DDL compatible con Postgres. El ejecutor de migraciones es agnóstico al dialecto por convención, por lo que un adaptador de Postgres puede reemplazar better-sqlite3 más adelante sin tocar las migraciones.
• crawler/ — adaptadores de fuentes (empezando con The Infatuation) que normalizan en el esquema de la base de datos. Mapeo de endpoints/campos: docs/infatuation-data-surface.md (paso 2).
• mcp/ — servidor MCP stdio (@modelcontextprotocol/sdk) que expone herramientas de búsqueda, detalle, comparación y guías.

Inicio rápido

npm install
npm run typecheck
npm run build
node db/dist/migrate.js ./nycfoodie.db   # creates/opens the SQLite db, applies migrations
node mcp/dist/index.js                   # starts the MCP server on stdio

Hoja de ruta

1. Andamiaje (hecho) — repositorio, paquetes, ejecutor de migraciones, herramientas MCP preliminares.
2. Mapear la superficie de datos de The Infatuation — páginas Next.js + endpoints GraphQL → docs/infatuation-data-surface.md.
3. Propuesta de esquema de base de datos — mostrada para aprobación antes de escribir cualquier código de rastreador.
4. Rastreador — solo después de la aprobación del esquema.

Convenciones

• Inglés británico en documentación y texto dirigido al usuario.
• Migraciones: numeradas NNN_name.sql, aplicadas una vez en orden; consulta db/migrations/README.md para las reglas de compatibilidad con Postgres.
• Nunca confirmes archivos *.db ni credenciales.