ご利用ありがとうございます！開発の合間のコーヒー代として温かいご支援をお待ちしています。

PayPalで支援する

ZIPCODA MCP Server

ZIPCODA MCP は、本サービス（ZIPCODA）のAPIを利用して郵便番号や住所の情報を取得するための Model Context Protocol （MCP）サーバーです。

Claude Desktop や VSCode などの MCP対応クライアントで利用することができます。

基本的なセットアップ

MCP対応クライアントの設定に以下のように追加してください（細部はクライアントによって異なります）：

{
  "mcp": {
    "servers": {
      "zipcoda-mcp": {
        "type": "stdio",
        "command": "npx",
        "args": ["github:mach3/zipcoda-mcp"]
      }
    }
  }
}

環境によっては npx の代わりに npm で実行する必要があります：

{
  "mcp": {
    "servers": {
      "zipcoda-mcp": {
        "type": "stdio",
        "command": "npm",
        "args": [
          "exec",
          "--yes",
          "--",
          "github:mach3/zipcoda-mcp"
        ]
      }
    }
  }
}

技術的な情報

このMCPサーバーはNode.jsで実装されており、ローカル環境でサーバーを起動します。クライアントは標準入出力（stdio）を通じてサーバーと通信します。

利用可能なツール

ツール名	説明
search_by_zipcode	郵便番号から住所を検索
search_by_address	住所から郵便番号を検索

使用例

以下のようなプロンプトで検索することができます：

「郵便番号1000001の住所を教えて」
「渋谷区の郵便番号はいくつ？」

動作要件

Node.js 18.x 以上
ZIPCODA API に接続できるインターネット接続環境

関連リンク

GitHub リポジトリ