zyfy-mcp

@zyfy-uk/mcp

Zyfy 用の MCP サーバーです。Claude、Cursor、その他の AI エージェント向けに、英国の郵便番号と車両に関する情報を提供します。

このサーバーを Claude Desktop、Claude Code、または Cursor に追加すると、英国の郵便番号や車両について自然言語で質問できます。コードは不要です。

前提条件

• Node.js 18 以降
• Zyfy API キー — zyfy.uk で無料登録（無料プランには月100リクエストが含まれます）。キーは ea_live_... のような形式です。

セットアップ

Claude Desktop

Claude Desktop の設定ファイルに追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "zyfy": {
      "command": "npx",
      "args": ["-y", "@zyfy-uk/mcp"],
      "env": {
        "ZYFY_API_KEY": "ea_live_your_key_here"
      }
    }
  }
}

ファイルを保存した後、Claude Desktop を再起動してください。

Claude Code

プロジェクトのルートに .mcp.json ファイルを追加します。

{
  "mcpServers": {
    "zyfy": {
      "command": "npx",
      "args": ["-y", "@zyfy-uk/mcp"],
      "env": {
        "ZYFY_API_KEY": "ea_live_your_key_here"
      }
    }
  }
}

注： API キーが含まれている場合は、.mcp.json をコミットしないでください。.mcp.json を .gitignore に追加してください。

グローバル設定（すべてのプロジェクトに適用する設定）にする場合は、代わりに同じブロックを ~/.claude.json に追加します。

同じ .mcp.json 形式は、Cursor やその他の MCP 対応クライアントでも使用できます。

利用可能なツール

ツール	説明
lookup_postcode	英国の任意の郵便番号について、洪水リスク、犯罪率、ブロードバンドのカバレッジ、平均住宅価格、剥奪指数（IMD）、国会議員の詳細を取得します
lookup_vehicle	英国の任意の車両登録番号について、メーカー、MOT履歴、税金／MOTの状態と期限、ULEZ適合状況、安全スコア、走行距離の推移を取得します
nearest_postcode	緯度／経度の座標に最も近い郵便番号の詳細な付加情報を取得します
postcodes_within	緯度／経度の座標から指定した半径内のすべての郵便番号と、それぞれの詳細な付加情報を取得します

完全なレスポンススキーマとシグナルのリファレンスについては、zyfy.uk/docs をご覧ください。

プロンプトの例

• SW1A 2AA の洪水リスクはどのくらいですか？
• AB12 CDE は ULEZ に適合していますか？MOT の期限はいつですか？
• 51.5074, -0.1278 に最も近い郵便番号の平均住宅価格と犯罪率はどのくらいですか？
• 51.5, -0.1 から500メートル以内にあるすべての郵便番号と、それぞれの洪水リスク区分を一覧表示してください。

クォータ

ツールを呼び出すたびに、Zyfy アカウントのクォータを1単位使用します。postcodes_within は、返される郵便番号1件につき1単位を使用します。残りのクォータは各レスポンスに含まれます。プランの詳細については、zyfy.uk/pricing をご覧ください。

クォータを使い切ると、リセット日とアップグレードへのリンクを含むメッセージがツールから返されます。1分あたりのレート制限に達すると、待機する秒数を示すメッセージが返されます。

レスポンスに "enrichmentPending": true が含まれている場合、Zyfy はそのレコードをバックグラウンドで処理中です。結果には現時点で利用可能な最良のデータが含まれます。完全な結果を得るには、数秒後に再試行してください。

ライセンス

MIT