NYCfoodie

NYCfoodie

レストランの好みに関するデータレイヤーです。MCP 経由で AI エージェントに、構造化された編集者選定のレストランおすすめ情報を提供します。単なるレビューのスクレイパーではありません。厳選されたガイドとレビューをひとつのスキーマに正規化し、ツールから照会できます。

MVP の対象都市はニューヨークです。都市はあらゆる箇所でパラメーターとして扱われ、NYC 固有の情報がハードコードされることはありません。

利用方法

ホストされたエンドポイント（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（アプリ） — Settings → Connectors → Add custom connector → 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）と、Postgres 互換の DDL で記述された番号付き SQL マイグレーションです。マイグレーションランナーは慣例として方言に依存しないため、後からマイグレーションに手を加えずに better-sqlite3 を Postgres アダプターに置き換えられます。
• 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 ファイルや認証情報は絶対にコミットしないでください。