Whereabot

Whereabot

AI エージェントが必要なときにあなたのスマートフォンに現在地を尋ねられるようにします。中継サーバーはご自身でホストします。サインインとユーザーデータには Supabase を使用します。

flowchart LR
  Agent["AI agent"] -->|"MCP or HTTP"| Relay["Relay (Rust)"]
  Relay -->|WebSocket| Phone["Phone app (Tauri)"]
  Phone -->|"GPS fix"| Relay
  Relay -->|"answer"| Agent

中継サーバーは位置情報の履歴を保持しません。位置確認の通知を送り、スマートフォンがその時点の GPS 情報を取得し、エージェントに回答を返します。保存される情報、その保存期間、位置情報を確認できる人については、プライバシーをご覧ください。

ステータス

ベータ版の初期 MVP です。iOS はプッシュ通知を通じてバックグラウンドで応答します。Android はアプリが開いている間のみ応答します。ロードマップをご覧ください。

リポジトリの構成

パス	内容
server/	Rust 製の中継サーバー（axum）です。エージェントは HTTP または MCP 経由で呼び出し、スマートフォンは WebSocket で接続します。
app/	Tauri v2 製のスマートフォンアプリ（Android／iOS）です。サインイン後、GPS 情報を使って位置確認の通知に応答します。
supabase/	データベースのマイグレーションとテストです。
infra/	開発環境と本番環境向けの OpenTofu コードです。
scripts/	ローカル開発、エンドツーエンドチェック、デプロイ、フックのインストール用スクリプトです。
docs/	ドキュメントサイトのソースです。
site/	ランディングページと OAuth 同意ページです。
docs-site/	ドキュメントサイトの VitePress ビルドです。
design-system/, brand/	共有 CSS トークンとコンポーネント、ロゴファイルと使用ルールです。

エージェントを接続する

1. アプリをインストールします。whereabot.io のスタートガイドをご覧いただくか、ブラウザーからインストールしてください。

2. スマートフォンで Google アカウントを使ってサインインします。

3. 中継サーバーをエージェントに追加します。

   claude mcp add --transport http whereabot https://relay.whereabot.io/mcp
   

4. Claude Code で /mcp を実行し、スマートフォンと同じ Google アカウントでサインインします。トークンを貼り付ける必要はありません。

5. Android では、Android のプッシュ通知が利用可能になるまで、エージェントが位置確認を求めている間はアプリを開いたままにしてください。

中継サーバーの URL：稼働中の URL。ツールと引数については、プロトコルをご覧ください。

セルフホスト

infra/ の OpenTofu コードを使って、ご自身の中継サーバーと Supabase プロジェクトを実行します。手順はinfra/README.mdをご覧ください。ご自身の Supabase と中継サーバーの値を設定してアプリをビルドし（app/.env.example）、中継サーバーをエージェントに追加します。まず 1 台のコンピューターですべてを実行するには、ローカルクイックスタートをご覧ください。

ドキュメント

生成された MCP およびワイヤー形式のリファレンスを含むすべてのドキュメントは、whereabot.io/docsをご覧ください。このリポジトリ内のドキュメント：

• アーキテクチャ：コンポーネント、サインインと位置確認のフロー、セキュリティ、制限
• プロトコル：意図レベルでの HTTP、MCP、WebSocket
• リクエストフロー：1 回のリクエストにおけるすべての状態、通知、エージェントへの結果
• 位置情報の共有：別の人のエージェントがあなたの位置情報を尋ねられるようにする方法
• プライバシー：保存される情報、保持期間、位置情報を確認できる人
• 運用とインフラストラクチャ：実行、デプロイ、リリースの方法
• 先行事例とロードマップ
• 掲載情報：MCP ディレクトリ、server.json、公開方法

コミュニティ

• 貢献：ローカル環境のセットアップ、フック、ルール、マイグレーションの追加
• セキュリティポリシー：脆弱性を非公開で報告する方法
• 行動規範

ライセンス

MIT。サードパーティの素材：THIRD_PARTY_NOTICES.md。