NYCfoodie

NYCfoodie

餐厅口味数据层：通过 MCP 向 AI Agent 提供结构化、编辑精选的餐厅推荐。这不是又一个评论抓取工具，而是将精选指南和评论规范化为统一的架构，并可通过工具查询。

MVP 城市：纽约。城市在所有地方都是一个参数；没有任何针对纽约的硬编码内容。

使用方法

托管端点（Streamable HTTP）：https://nycfoodie-production.up.railway.app/mcp

• Cursor — 一键安装
• Claude Code — claude mcp add --transport http nycfoodie https://nycfoodie-production.up.railway.app/mcp
• Windsurf / Cline / Roo Code / Zed / VS Code — 添加到你的 MCP 配置中：

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

• Claude（应用） — 设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。
• 任何 MCP 客户端 — 将上方 URL 添加为远程服务（Streamable HTTP）。无需身份验证，也无需安装。

工具

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

目录结构

• db/ — SQLite 存储（better-sqlite3），包含编号的 SQL 迁移文件，使用兼容 Postgres 的 DDL。按照约定，迁移运行器与方言无关，因此之后可以用 Postgres 适配器替换 better-sqlite3，而无需改动迁移文件。
• crawler/ — 将数据规范化为 db 架构的来源适配器（从 The Infatuation 开始）。端点/字段映射：docs/infatuation-data-surface.md（第 2 步）。
• mcp/ — stdio MCP 服务（@modelcontextprotocol/sdk），提供搜索、详情、比较和指南工具。

快速开始

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

路线图

1. 搭建脚手架（已完成）——仓库、软件包、迁移运行器、MCP 工具存根。
2. 梳理 The Infatuation 的数据面——Next.js 页面 + GraphQL 端点 → docs/infatuation-data-surface.md。
3. 数据库架构提案——在编写任何爬虫代码之前提交审批。
4. 爬虫——仅在架构获批后开始。

约定

• 文档和面向用户的文本使用英式英语。
• 迁移文件：编号格式为 NNN_name.sql，按顺序各应用一次；Postgres 兼容规则见 db/migrations/README.md。
• 切勿提交 *.db 文件或凭据。