様々なAgentへ — Smithery 経由で Staddress MCP を入れる
住所正規化・ジオコーディングAPI 「Staddress（スタドレス）」 開発チームです。
前回（Cursorから15分 — @staddress/mcp でチャットから住所解析する）は、Cursor Directory から MCP を入れる手順を紹介しました。
今回は Smithery への掲載を紹介します。Cursor 以外の MCP 対応エージェントにも、同じ @staddress/mcp を届けやすくなりました。
- Smithery: sys-y623/staddress
- npm:
@staddress/mcp - ソース: packages/mcp
この記事で扱う内容は次の通りです。
- Smithery に載せた理由（Cursor 以外への流入）
- 掲載ページで何が分かるか
- Smithery CLI で各エージェントへ入れる
- 提供ツールとチャットでの試し方
- Cursor Directory との使い分け
- よくあるつまづき
前提
- Free アカウント登録が完了していること
- アカウント管理画面で API Key を確認できること
-
Node.js 18+（Smithery CLI /
npx用） - MCP 対応の AI クライアント（Cursor / Claude Desktop など）
API Key の取得は 試用編 / curl 編 を参照してください。
なぜ Smithery か
Cursor Directory は Cursor 利用者向けの入口として有効です。一方で、MCP クライアントは Cursor 以外にも広がっています。
Smithery は MCP サーバのレジストリ兼ハブで、掲載ページから 複数のエージェント向けにインストールしやすくなります。アプリ本体のコード変更は不要で、既存の @staddress/mcp をそのまま公開しています。
発見: Smithery ページ / CLI 検索
↓
導入: smithery mcp add → 各 Agent の設定へ
↓
実行: staddress_parse など → Staddress AI API
掲載ページ
公開 URL はこちらです。
https://smithery.ai/servers/sys-y623/staddress
ページ上では次が確認できます。
- 日本語の説明（住所の正規化・分解、緯度経度・信頼度）
- 提供ツール 3 つ（後述）
- Quick Start（CLI での追加・ツール一覧・呼び出し例）
- Direct MCP Connection（ホスト済みエンドポイント）
利用には Staddress の API キーが必要です（ページ上でも案内されています）。
Step 1. Smithery 経由でインストールする
ワンライナーの例です（掲載ページの Quick Start と同じ系統）。
npx -y smithery mcp add sys-y623/staddress
クライアントを明示する場合の例:
# Cursor
npx -y smithery mcp add sys-y623/staddress --client cursor
# Claude Desktop
npx -y smithery mcp add sys-y623/staddress --client claude
CLI をグローバルに入れる場合:
npm install -g smithery@latest
smithery mcp add sys-y623/staddress --client cursor
インストール時に API Key（STADDRESS_API_KEY / 画面上の X-Api-Key 相当）を求められたら、アカウント管理画面のキーを入力します。
注意: API Key は秘密情報です。チャットログやリポジトリに載せないでください。
設定反映後、クライアントを再起動（または MCP をリロード）し、ツール一覧に staddress_parse が出ることを確認します。
ツールの確認・試し打ち（任意）
# ツール一覧
npx -y smithery tool list sys-y623/staddress
# スキーマ確認
npx -y smithery tool get sys-y623/staddress staddress_parse
Step 2. 提供ツール
前回の Cursor 編と同じ 3 ツールです。
| ツール | 対応 API | 説明 |
|---|---|---|
staddress_parse |
POST /api/v1/addresses/parse |
単件の正規化・分解 |
staddress_parse_batch |
POST /api/v1/addresses/parse/batch |
一括（Standard 以上・最大100件） |
staddress_get_usage |
GET /api/v1/usage |
利用状況 |
いずれも読み取り専用です。内部実装は公式 Node SDK @staddress/client です。
Step 3. チャットで試す
エージェント側のチャットに、例えば次のように入力します。
東京都渋谷区道玄坂1-2 マンション桜 101号を staddress で正規化して、緯度経度も教えて
AI が staddress_parse を呼ぶと、正規化住所・構成要素・緯度経度・信頼度が構造化データとして返ります。レスポンスの見方は curl 編 / Cursor MCP 編 と同じです。
| 目的 | プロンプト例 |
|---|---|
| 単件 | 「この住所を staddress で正規化して。建物名と部屋番号も分けて」 |
| 利用状況 | 「staddress の今月の利用状況を確認して」 |
| 一括（Standard+） | 「次の住所リストを batch で解析して」 |
Cursor Directory との使い分け
| 観点 | Cursor Directory（第10回） | Smithery（今回） |
|---|---|---|
| 主な読者 | Cursor 利用者 | 複数 Agent 利用者 |
| 入口 | cursor.directory/plugins/staddress-ai | smithery.ai/servers/sys-y623/staddress |
| 導入 | Directory UI / mcp.json
|
smithery mcp add など |
| 本体 | 同じ @staddress/mcp
|
同じ @staddress/mcp
|
どちらから入れても、呼び出す API・ツール名・レスポンスは共通です。Cursor だけ使うなら Directory、他のエージェントにも配りたい・CLI で入れたいなら Smithery、という切り分けで十分です。
AI エージェントに住所解析ツールを足す利点（LLM の推測ではなく公式 API の結果を根拠にできること）は、Cursor 編の使い分け と同じです。
よくあるつまづき
インストール後にツールが出ない
- クライアントの再起動 / MCP リロード
-
node -vが 18 以上か -
smithery mcp listで接続が残っているか
API Key エラー
Smithery / クライアント設定にキーが入っているか確認してください。未設定のままでは unauthorized 相当になります。
batch が使えない
staddress_parse_batch は Standard プラン以上です。Free では単件の staddress_parse を使ってください。
まとめ
- Smithery 掲載: sys-y623/staddress
-
npx -y smithery mcp add sys-y623/staddressで各種 Agent へ導入できる - ツールは
staddress_parse/staddress_parse_batch/staddress_get_usage（Cursor 編と同じ） - コード変更は不要。既存
@staddress/mcpの発見性を上げる施策 - Cursor 専用なら Directory、横断配布なら Smithery
Staddress ホームセット
Staddress に関する公式リンク一覧です。