Anwani

Anwani MCP

Anwani MCP は、実際の場所に紐づく恒久的な9桁の住所コードを提供するデジタル住所インフラストラクチャである Anwani に、AI エージェントを接続します。

OAuth を通じて Anwani の住所を作成、一覧表示、更新、共有、削除できます。Anwani 全体で使用されているものと同じ所有権、権限、アカウント制限が適用されます。

Cursor やその他の MCP 対応クライアントで使用できます。

製品ページ：https://9code.app/ai-agents

サインインには、ブラウザーで Google OAuth + PKCE を使用します。一度承認すると、クライアントがこのマシンにトークンを保存します。

OAuth クライアント ID：anwani-cursor

このパッケージは接続クライアントのみです。Firebase プロジェクトの内部情報、Firestore のパス、サーバーのシークレットは含まれていません。

要件

• Node.js 18+
• MCP 対応クライアント（Cursor をサポートしています。他のクライアントも stdio 経由で同じように動作します）
• Anwani アカウント（初めて利用する場合は、Google の同意時に自動作成されます）

インストール

npm install -g anwani-mcp
anwani-mcp-login

グローバルインストールを使用しない場合：

npx -y anwani-mcp-login

実行される内容：

1. このマシンでローカルコールバックサーバーが起動します
2. ブラウザーで Anwani の認証ページが開きます
3. Google でサインインし、許可をクリックします
4. ブラウザーが localhost に戻り、ブリッジがトークンを自動的に保存します

JSON を貼り付ける必要はありません。コードやトークンをチャットに貼り付けないでください。

フォールバック（まれなケース）：ネットワークでループバックがブロックされている場合は、anwani-mcp-login --paste を使用してください。

Cursor で使用する

Cursor は最初にサポートされた MCP クライアントです。推奨設定（常に公開済みパッケージを使用します）：

{
  "mcpServers": {
    "anwani": {
      "command": "npx",
      "args": ["-y", "anwani-mcp"]
    }
  }
}

次に、新しいチャットを開き、Anwani に住所の作成または更新を依頼します。実際の地図上のピン（座標または Maps のリンク）を指定してください。エージェントが場所を捏造してはいけません。

ツール

ツール	必要なスコープ	備考
session	—	接続と許可されたスコープ（内部 ID は含みません）
list_addresses	address:read	自分の住所のみ
create_address	address:create	idempotency_key と、ユーザーが指定する実際の緯度・経度が必要です
patch_address	address:update	フィールドの一部更新。作成後は座標を変更できません
share_address	address:share	公開用の 9code.app/code/… リンク
delete_address	address:delete	取り消せない操作

このクライアントでは写真をアップロードできません。写真には Anwani アプリまたは Telegram を使用してください。

セキュリティ

• トークンは ~/.anwani-mcp/ に保存されます（このパッケージ内には保存されません）。
• アクセストークンは不透明な anwani_at_… 値です。
• アプリ／Telegram と同じアカウント上限が適用されます（通常は住所10件）。
• ログインを再度実行して失効させる（再同意により以前のトークンが無効になります）か、[email protected] にメールを送信して取り消します。

ソースから実行する

git clone https://github.com/Anwani-app/anwani-mcp.git
cd anwani-mcp
node login.mjs

スモークテスト

クローンから実行する場合：

node smoke.mjs

公開／ディレクトリ

Official MCP Registry、Glama、Smithery、npm については、PUBLISH.md を参照してください。

• ローカル（Cursor など、任意の MCP クライアント）：anwani-mcp-login の実行後に npx -y anwani-mcp
• リモート：https://us-central1-nine-code-anwani.cloudfunctions.net/mcpRemote

ライセンス

MIT