mcp-hub-core

MCP Hub コアルール

このプロジェクトは家具・家電・ガジェット等のAIエージェント向けMCPハブ。 rules/*.md はタスクに必要なものだけ読む（毎回すべてを開かない）。全体像はルート AGENTS.md、ツールの使い方の詳細は public/AGENTS.md。カタログ件数・ツール数など断定値はコードで確認すること。

🚨 情報漏洩防止（絶対最優先 — 全ルールに優先する）

以下に違反した場合、他の全作業を即座に中止して修正すること。

禁止事項

• APIキー・シークレット・トークンをソースコードやコメントに直書き禁止（.envのみ許可）
• アフィリエイトID・APIキーの実際の値をコメント・ドキュメント・テストコード・ログ例に記載禁止
• IPアドレス・個人名をソースコード・ドキュメントに記載禁止
• .env.exampleには your_xxx_here や xxxxxxxx 等のダミー値のみ使用すること

コミット前チェック（必須）

1. git diff --cached で以下のパターンが含まれていないことを確認:
   • APIキーの実値（英数字+ハイフンの長い文字列）
   • アフィリエイトIDの実値（ドット区切りのHEX文字列）
   • AIzaSy で始まる文字列（Google APIキー）
   • pk_ / sk_ で始まる文字列（各種APIキー）
   • IPアドレス（xxx.xxx.xxx.xxx 形式）
2. 新規ファイル・ドキュメント更新時は必ず上記パターンでgrepし、漏洩がないことを確認すること

万が一漏洩した場合

1. 即座にファイルから除去（<REDACTED> に置換）
2. 原本は .secrets_backup/ に隔離（.gitignore 済み）
3. 漏洩したキーは必ず再発行（旧キーは無効化）
4. Git履歴に残っている場合は BFG Repo-Cleaner 等で除去を検討

コンプライアンス（最優先）

違反はリリースブロッカー。細目は rules/affiliate.md（Amazon/楽天・JSON-LD・公開文言）、rules/privacy.md（intent・ログ種別・インフラログの書き方）。

• アフィリエイト: フッター開示・実態と異なる表現禁止・価格注記。Amazon は URL 生成のみ等。
• JSON-LD: 虚偽の評価・件数の断定禁止。ページ上の可視テキストと整合。
• プライバシー: 「個人情報を一切収集しない」とは断言しない。
• ドキュメント: ツール説明は実装と一致。公開ファイル間で表現を揃える。

開発ルール

1. 全MCPツールに intent 引数を含めること → rules/insight-collection.md
2. 全検索結果を logs/analytics.jsonl に記録すること → rules/logging.md
3. 個人情報を意図的に記録しないこと → rules/privacy.md
4. サイズはmm単位、価格は円（整数）で統一 → rules/typescript.md
5. 外部入力は必ずZodでバリデーションすること → rules/typescript.md
6. 付加価値・実使用改善・通販外データの方針 → rules/mcp-value-iteration.md（レスポンスに次ツール案 recommended_follow_up を含めること）

モード別ルール

• 実装モード: 上記5項を遵守してコーディング
• 情報収集モード: .cursor/rules/research-mode.mdc を使用（コード変更不可）
• 役割分担: rules/model-routing.md を参照

Cursor / Composer

• このリポジトリを開いているときはルート AGENTS.md を最初のコンテキストに使う。
• 別アプリのフォルダ（別リポジトリ）を同じワークスペースに混ぜるとルールとコードが噛み合わない。フォルダ単位で開き直すと安定する。