Compass Daas

Compass DaaS MCP

Compass DaaS 用の MCP サーバーです。Model Context Protocol を通じて、読み取り専用のレストランツール（検索、情報補完、適合性判定）を 3 つ提供し、API キーを使って Compass REST API を呼び出します。対象範囲は米国の 50 州とワシントン D.C. です。

Compass はアレルゲンや安全性に関するサービスではありません。

このパッケージは、更新が終了した @compass-food/mcp に代わるものです。MCP クライアントの設定で @compass-food/mcp を @compassfoodtech/mcp に変更してください。

クイックスタート

npx -y @compassfoodtech/mcp

サーバーを起動する前に COMPASS_API_KEY を設定してください。

export COMPASS_API_KEY="<paste the key from signup>"

ステージングまたはローカルテストの場合は、次を設定してください。

export COMPASS_BASE_URL=https://daas-api-veganmapai-1a8b7.a.run.app

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compassfoodtech/mcp"],
      "env": {
        "COMPASS_API_KEY": "<paste the key from signup>"
      }
    }
  }
}

Cursor

Cursor の MCP 設定に追加します（グローバル設定は ~/.cursor/mcp.json、ワークスペース内の設定は .cursor/mcp.json）。

{
  "mcpServers": {
    "compass": {
      "command": "npx",
      "args": ["-y", "@compassfoodtech/mcp"],
      "env": {
        "COMPASS_API_KEY": "<paste the key from signup>"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml を編集します。

[mcp_servers.compass]
command = "npx"
args = ["-y", "@compassfoodtech/mcp"]

[mcp_servers.compass.env]
COMPASS_API_KEY = "<paste the key from signup>"

API キーの取得

サインアップすると、すぐに利用可能なサンドボックスキーが保存されます。このキーには 72 時間有効な 250 クレジットが付与されます。メールアドレスを確認すると、共有の無料利用枠が月 1,000 クレジットに増えます。

ツール

compass_search

POST /v1/search を呼び出します。 mode ツール引数は、X-Compass-Mode ヘッダーとして REST API に送信されます。 料理名は dish に、目的地は place または location に指定してください。両方を同時に指定することはできません。各結果には vegan_dining（関連するビーガン料理を最大 5 件）と menu_collected_at が含まれます。料理を指定した検索で、その料理を提供するレストランが見つからない場合は result_status: "no_match" が返され、50 km 以内に該当するレストランがある場合は nearest_match も返されます。include_cuisine_matches を設定すると、料理は提供していないものの同じ料理ジャンルのレストランも cuisine_only として一覧に追加されます。

{
  "query": "ramen",
  "dish": "ramen",
  "place": { "country_code": "US", "region": "NY", "city": "Brooklyn" },
  "user_profile": { "diet": "strict_vegan" },
  "limit": 5
}

{
  "query": "vegan ramen in Brooklyn",
  "user_profile": {
    "diet": "strict_vegan",
    "exclude_cross_contamination": true
  },
  "location": {
    "lat": 40.6782,
    "lng": -73.9442,
    "radius_m": 5000
  },
  "limit": 10,
  "mode": "rich"
}

compass_enrich_restaurant

POST /v1/enrich/restaurant を呼び出します。 正確な検索には compass_id または google_place_id のどちらか一方を使用します。または、name と address、あるいは name と place を指定します。matched が true になるのは、identity_status が resolved の場合のみです。それ以外の場合は、候補となるレストランが match_candidates に一覧表示されます。

{
  "name": "Buddha Bodai",
  "address": "5 Mott St, New York, NY"
}

{
  "name": "Blossom",
  "place": { "country_code": "US", "region": "NY", "city": "New York" },
  "dish": "seitan"
}

compass_decide_fit

POST /v1/decision/restaurant-fit を呼び出します。 mode ツール引数は、X-Compass-Mode ヘッダーとして REST API に送信されます。 compass_id または google_place_id のいずれか一方のみを指定してください。vegan_options は strict_vegan の別名です。完全菜食主義者向けのレストランのみを対象とするには、fully_vegan_only を設定してください。vegetarian はビーガンに関する情報に基づいて判定されます。それ以外の対応している食事制限では、DIET_NOT_SUPPORTED とともに unknown が返されます。 exclude_cross_contamination のデフォルト値は false です。共有調理環境についての情報が不明な場合に unknown を返すには、true を指定してください。 google_place_id がレストランに対応しない場合、または複数のレストランに対応する場合、判定の代わりに resolution と coverage が返されます。

{
  "compass_id": "rest_xyz789",
  "user_profile": {
    "diet": "strict_vegan"
  },
  "mode": "rich"
}

API キーの解決方法

サーバーは次の順に確認します。

1. COMPASS_API_KEY
2. ~/.compass/config.json

設定ファイル：

{
  "api_key": "<paste the key from signup>",
  "base_url": "https://api.compassfoodtechnologies.com"
}

プライバシー

このパッケージは、設定された Compass API ベース URL に対してのみツール呼び出しを送信します。二次的な使用状況データは送信しません。

リンク

• サイト：https://compassfoodtechnologies.com
• サインアップ：https://compassfoodtechnologies.com/signup?src=mcp
• サポート：[email protected]
• ライセンス：MIT