Uganda Online Business Directory

Muyiribi

ウガンダのビジネスディレクトリです。Cloudflare Worker と Neon Postgres を使用し、シンプルな Web UI と AI ツール向けの MCP エンドポイントを備えています。

ルート

• / ランディングページ
• /search キーワード、カテゴリ、地区でビジネスを公開検索
• /signup、/login、/logout 電話番号とパスワードによるアカウント（パスワードの表示／非表示切り替え）
• /dashboard サインイン中のアカウントのビジネス掲載情報とプランの上限を管理
• /add ビジネス掲載情報を追加（作成上限はプランによって異なります。説明文は40文字以上）
• /listings/:id/edit サインイン中のアカウントが所有する掲載情報を安全に編集
• /mcp ツールを備えた MCP エンドポイント：search_businesses、get_business、list_categories

検索結果はプランの上位順に表示されます（ブラック、グリーン、ブルー、無料）。

セットアップ

1. Neon SQL コンソールで schema.sql を一度実行します。
2. 依存関係をインストールします：npm install
3. データベースシークレットを設定します：npx wrangler secret put DATABASE_URL（Neon の接続文字列）
4. ローカル開発：npm run dev
5. デプロイ：npm run deploy

MCP URL：https://ug-online.domus-dei-tech.workers.dev/mcp。

メモ

• パスワードは PBKDF2（Web Crypto）でハッシュ化されます。ログインに5回失敗すると、アカウントは15分間ロックされます。
• 作成上限（アカウントが作成できる掲載情報の件数）：Free 3、Basic 5、Pro 7、Premium 無制限。
• 検索上限（検索結果に表示できるアカウントの掲載情報の件数）：Free 1、Basic 3、Pro 5、Premium 無制限。新しい順に表示されます。
• 検索結果はプランの上位順に表示されます。
• 有料プランは、有効なサブスクリプションがある場合にのみ適用されます。サブスクリプションを作成するフローはまだなく、決済機能は後日追加されます。
• /pricing ではすべてのプランを表示し、PesaPal で販売します。有料プラン（Basic UGX 5,000/年、 Pro UGX 12,000/年、Premium UGX 25,000/年）を適用するには、UgaText 経由で送信される SMS OTP によるビジネス連絡先電話番号の確認が必要です。migrations/002_verification.sql と migrations/003_tier_names_and_pricing.sql、および migrations/004_payment_phone_optional.sql を参照してください。
• 有料プランのフローは1ページで完結します。「Get 」をクリックすると PesaPal の注文が作成され、/pricing/status の iframe にチェックアウト画面が表示されます。決済が完了するまでページが /pricing/check をポーリングし、その後、確認用の電話番号（事前入力済みで編集可能）を求め、SMS コードを送信します。ステータスは PesaPal の GetTransactionStatus のみを信頼し、コールバック URL の情報は信頼しません。

MCP Registry

• ステップ 0： server.json のバージョンを更新します

• ステップ 1： curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher chmod +x mcp-publisher

• ステップ 2： ./mcp-publisher login github ./mcp-publisher validate server.json ./mcp-publisher publish server.json

MCP

• 作成するフォルダーの外から最初のコマンドを実行します。
• my-mcp-server をサーバー名に変更します scaffold: npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless
  Cloudflare から Workers 用のトークンを取得します cd my-mcp npm install npx wrangler dev # ローカル開発 npx wrangler deploy # デプロイ