NYCfoodie

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

NYCfoodie

A camada de dados para o paladar de restaurantes: recomendações editoriais e estruturadas de restaurantes servidas a agentes de IA via MCP. Não é outro raspador de avaliações — guias e resenhas curadas normalizadas em um único esquema, consultável por ferramentas.

Cidade do MVP: Nova York. A cidade é um parâmetro em todos os lugares; nada específico de NYC é codificado.

Como usar

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

• Cursor — instalação em um clique
• Claude Code — claude mcp add --transport http nycfoodie https://nycfoodie-production.up.railway.app/mcp
• Windsurf / Cline / Roo Code / Zed / VS Code — adicione à sua configuração MCP:

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

• Claude (app) — Configurações → Conectores → Adicionar conector personalizado → cole a URL.
• Qualquer cliente MCP — adicione a URL acima como servidor remoto (HTTP Streamable). Sem autenticação, sem instalação.

Ferramentas

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

Estrutura

• db/ — armazenamento SQLite (better-sqlite3) com migrações SQL numeradas escritas em DDL compatível com Postgres. O executor de migrações é agnóstico de dialeto por convenção, então um adaptador Postgres pode substituir o better-sqlite3 posteriormente sem tocar nas migrações.
• crawler/ — adaptadores de fonte (começando com The Infatuation) que normalizam no esquema do banco de dados. Mapeamento de endpoint/campo: docs/infatuation-data-surface.md (etapa 2).
• mcp/ — servidor MCP stdio (@modelcontextprotocol/sdk) expondo ferramentas de busca, detalhes, comparação e guias.

Início 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

Roadmap

1. Estrutura inicial (concluída) — repositório, pacotes, executor de migrações, ferramentas MCP stub.
2. Mapear a superfície de dados do The Infatuation — páginas Next.js + endpoints GraphQL → docs/infatuation-data-surface.md.
3. Proposta de esquema do banco de dados — apresentada para aprovação antes de qualquer código de crawler ser escrito.
4. Crawler — somente após a aprovação do esquema.

Convenções

• Inglês britânico em documentação e textos voltados ao usuário.
• Migrações: numeradas NNN_name.sql, aplicadas uma vez em ordem; veja db/migrations/README.md para as regras de compatibilidade com Postgres.
• Nunca commitar arquivos *.db ou credenciais.