Lob について
Lob MCPは、米国住所の単件・一括検証とオートコンプリートを提供し、配達可能性の確認や住所候補の提示が必要なアプリケーション向けです。`_apiKey`でLob APIキーを渡します。
主な機能
- 01米国住所の単件検証
- 02住所の一括検証
- 03住所入力の補完
- 04USPS準拠情報の返却
活用シーン
- 01住所の配達可能性確認
- 02住所リストの一括整理
- 03住所入力時の候補提示
MCP 対応
MCPクライアントに、Lobの住所検証・一括検証・オートコンプリートツールを公開します。Pipeworxゲートウェイ経由で接続するか、ローカルのstdio MCPサーバーとして実行できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://gateway.pipeworx.io/lob/mcpclaude mcp add --transport http pipeworx-io-lob https://gateway.pipeworx.io/lob/mcp{"mcpServers":{"pipeworx-io-lob":{"type":"http","url":"https://gateway.pipeworx.io/lob/mcp"}}}Cursor で開く{"servers":{"pipeworx-io-lob":{"type":"http","url":"https://gateway.pipeworx.io/lob/mcp"}}}VS Code で開く{"mcpServers":{"pipeworx-io-lob":{"type":"http","url":"https://gateway.pipeworx.io/lob/mcp"}}}{"mcpServers":{"pipeworx-io-lob":{"serverUrl":"https://gateway.pipeworx.io/lob/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
mcp-lob
Lob MCP — 米国住所の検証、一括検証、オートコンプリート(docs.lob.com)。BYO-key:_apiKey を使って Lob API キーを渡します。
Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携、承認、公開のいずれもしていません。
ツール
| ツール | 説明 |
|---|---|
lob_verify_address | 米国の住所を 1 件検証し、配達可能性を確認して、USPS 標準化・修正済みの各項目(ZIP+4、DPV コード、郡、緯度・経度)を返します。構造化された項目(primary_line、city、state、zip_code)か、単一の自由形式の address 文字列のどちらかを渡してください。両方は指定できません。例:lob_verify_address({ primary_line: "185 Berry St", secondary_line: "Ste 6100", city: "San Francisco", state: "CA", zip_code: "94107", _apiKey: "your-key" }) または lob_verify_address({ address: "185 Berry St Ste 6100 San Francisco CA 94107", _apiKey: "your-key" }) |
lob_verify_bulk | 米国の住所リストを 1 回のリクエストで検証します。各住所は primary_line、city、state、zip_code を含むオブジェクトです(secondary_line/recipient は任意)。住所ごとに配達可能性と修正済みの各項目を返します。例:lob_verify_bulk({ addresses: [{ primary_line: "210 King St", city: "San Francisco", state: "CA", zip_code: "94107" }], _apiKey: "your-key" }) |
lob_autocomplete | 米国の住所の入力を補完します。住所の先頭部分(任意で市、州、郵便番号も指定可能)を渡すと、最大 10 件の完全な住所候補を返します。候補は配達可能であることが保証されていません。lob_verify_address で検証してください。例:lob_autocomplete({ address_prefix: "185 B", city: "San Francisco", state: "CA", _apiKey: "your-key" }) |
クイックスタート
MCP クライアント(Claude Desktop、Cursor、Windsurf など)に追加します。
{
"mcpServers": {
"lob": {
"url": "https://gateway.pipeworx.io/lob/mcp"
}
}
}
このエンドポイントが実際に提供するもの
https://gateway.pipeworx.io/lob/mcp の tools/list は、上記の表に記載されたツールに加えて、共有 Pipeworx メタツール(ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できるツール群)を返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールとともに共有ツールが約 30 個表示されます。接続の initialize 応答には正確な範囲が示されており、その日の時点での確定情報となります。
これは意図した仕様であり、偶発的な多重化ではありません。メタツールを使うことで、このパックが対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を介して回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。
または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
どちらの URL も同じゲートウェイと同じ 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。
MCP クライアントがない場合:HTTP で呼び出す
このパックでは独自の API キー(_apiKey)を使用します。こちらで API キーを用意していないため、キーなしで実行できる curl の例はありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/lob_verify_address を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。
スタンドアロン(ゲートウェイアカウント不要)
このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントやゲートウェイへのラウンドトリップは不要です。
{
"mcpServers": {
"lob": {
"command": "npx",
"args": ["-y", "@pipeworx/mcp-lob"]
}
}
}
または、直接実行して起動することを確認できます。
npx -y @pipeworx/mcp-lob
stdin/stdout 経由で MCP を通信し、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。
ask_pipeworx での使用
ツールを直接呼び出す代わりに、自然な英語で質問できます。 これは、上記のパックエンドポイントでも、フルゲートウェイでも機能します。
ask_pipeworx({ question: "your question about Lob data" })
ゲートウェイが適切なツールを選択し、引数を自動的に入力します。
詳細
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。