cityparity: Cost-of-Living & Quality-of-Life Comparison について
cityparityは、都市間の給与、生活費、生活の質を比較するツールをエージェントに提供します。社会保障制度も含め、69カ国約165都市の移住や報酬計画に役立ちます。
主な機能
- 012都市の費用と給与の比較
- 02移住先で必要な給与の推定
- 03都市プロフィールと対応都市の検索
- 04品質スコアによる都市ランキング
- 05社会保障と入国者向け税制の確認
活用シーン
- 01都市間の移住先の比較
- 02海外移住に必要な給与の推定
- 03スコアや重みによる都市の選定
MCP 対応
MCPサーバーは、都市比較、都市情報、社会保障、ランキング、入国者向け税制のツールを提供します。Streamable HTTPでホストされ、HTTP MCP非対応クライアント向けにstdioからHTTPへのブリッジもあります。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://mcp.cityparity.com/mcpclaude mcp add --transport http cityparity https://mcp.cityparity.com/mcp{"mcpServers":{"cityparity":{"type":"http","url":"https://mcp.cityparity.com/mcp"}}}Cursor で開く{"servers":{"cityparity":{"type":"http","url":"https://mcp.cityparity.com/mcp"}}}VS Code で開く{"mcpServers":{"cityparity":{"type":"http","url":"https://mcp.cityparity.com/mcp"}}}{"mcpServers":{"cityparity":{"serverUrl":"https://mcp.cityparity.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
6| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| source_city | string | はい | ユーザーの現在の都市の city slug。list_cities を使用して有効な slug を確認してください(例:'nyc'、'seattle'、'tokyo')。 |
| target_city | string | はい | 移住先の都市の slug。 |
| gross_salary | number | はい | 出発都市の現地通貨での年間総支給額(例:Seattle は USD、Oslo は NOK)。 |
| household | object | いいえ | 家族構成:就労年齢のパートナーと扶養する子ども。子どものいない単身者は省略してください。 |
| household.has_partner | boolean | いいえ | ユーザーに就労年齢のパートナーがいるかどうか。デフォルトは false です。 |
| household.partner_gross_salary | number | いいえ | 出発都市の通貨でのパートナーの年間総支給額。has_partner=true の場合は必須です。 |
| household.partner_works_in_source | boolean | いいえ | パートナーが現在、出発都市で収入を得ているかどうか。has_partner=true の場合は必須です。配偶者の都市ごとの就労状況は計算結果に大きく影響するため、cityparity ではデフォルト値を設定しません(例:米国では保育費が第 2 の収入を上回る場合がありますが、北欧では補助金により第 2 の収入が成り立つ場合があります)。 |
| household.partner_works_in_target | boolean | いいえ | 移住後、パートナーが移住先の都市で収入を得るかどうか。has_partner=true の場合は必須です。 |
| household.kids_ages | array | いいえ | 扶養する子どもの年齢(例:[3, 7])。子どもがいない場合は空の配列を指定するか、省略してください。 |
| living | object | いいえ | 住居と支出に関する前提。省略すると、デフォルト値(賃貸、寝室 2 室、標準的な支出)が使用されます。 |
| living.housing_mode | enum | いいえ | 世帯が賃貸か持ち家か。デフォルトは賃貸です。rent | own | own_outright |
| living.bedrooms | integer | いいえ | 世帯の寝室数。デフォルトは 2 です。 |
| living.lifestyle | enum | いいえ | 食費と裁量的な支出項目に適用する支出倍率。デフォルトは標準(1.0×)です。frugal | typical | generous |
| advanced | object | いいえ | 任意の詳細調整項目:退職積立額、年齢層、帰国旅行、交通手段、入国時の税制。省略するとデフォルト値が使用されます。 |
| advanced.retirement_contrib_pct | number | いいえ | 退職積立に充てる総支給額の割合(米国の 401k では税引き前拠出)。デフォルトは 6 です。 |
| advanced.age_bracket | enum | いいえ | 米国の医療保険料の倍率に影響します。デフォルトは 25-34 です。18-24 | 25-34 | 35-44 | 45-54 | 55-64 |
| advanced.trips_home_per_year | integer | いいえ | 出発国への年間往復回数(移住先のみの費用)。デフォルトは 1 です。 |
| advanced.source_transit_choice | enum | いいえ | デフォルト値は都市によって異なります。例:Seattle は 'car'、Oslo は 'transit' がデフォルトです。car | transit |
| advanced.target_transit_choice | enum | いいえ | 移住先の都市についても同様です。car | transit |
| advanced.apply_inbound_regime | boolean | いいえ | 利用可能な場合は、移住先の特別な外国人労働者向け税制を適用します(イタリア impatriati、ポルトガル IFICI、ベルギー expat、ポーランド B2B ryczałt、ギリシャ inbound)。デフォルトは false です。移住先側にのみ適用されます。 |
| score_weights | object | いいえ | 総合スコアの重みを上書きします。デフォルト:financial 30、healthcare 20、vacation 15、childcare 15、safety_net 20。 |
| score_weights.financial | number | いいえ | |
| score_weights.healthcare | number | いいえ | |
| score_weights.vacation | number | いいえ | |
| score_weights.childcare | number | いいえ | |
| score_weights.safety_net | number | いいえ |
詳細
cityparity MCP サーバー
AI エージェントが呼び出せる、生活費と生活の質を比較するツールです。エージェントに2つの都市を指定すると、手取り額、詳細な費用内訳、移住先で必要となる同等の給与、そして実際に人々が移住を決める要因となる現金以外の差(休暇、育児休業、ユニバーサルヘルスケア)を返します。
https://mcp.cityparity.com/mcp でホストされています。無料で、API キーは不要です。エッジでレート制限されています。Model Context Protocol(仕様 2025-06-18、Streamable HTTP)を基盤としています。
- サイト:https://cityparity.com
- インストール方法(すべてのクライアント):https://cityparity.com/mcp
- 機械可読ドキュメント:https://mcp.cityparity.com/llms.txt
- OpenAPI(REST ミラー):https://mcp.cityparity.com/openapi.json
対応範囲
69か国、約165都市に対応しています。ほとんどの計算ツールは給与と家賃までしか扱いません。cityparity は社会保障制度(保育補助、育児休業、法定休暇、ユニバーサルヘルスケア)も算出するため、「給与が低い都市のほうが実際には得」という主張を、曖昧な話ではなく数値で示せます。
ツール
| ツール | 説明 |
|---|---|
compare_cities | 2つの都市を詳細に比較します。手取り額、費用内訳、移住先で必要となる同等の給与、ライフスタイルの差、生活の質のスコアを返します。 |
list_cities | 対応する都市のスラッグを国別に表示します。 |
get_city_summary | 1都市のプロフィールを表示します。税制の概要、主な費用、社会保障制度の値を確認できます。 |
rank_cities | 複合的な生活の質スコアに基づく上位 N 都市を、カスタムの重み付けや地域・国のフィルターとともに表示します。 |
get_safety_net | 1~20都市の育児休業、ユニバーサルヘルスケアの有無、休暇、祝日を表示します。 |
get_inbound_tax_regime | 外国人労働者向け税制を表示します。イタリアの impatriati、ポルトガルの IFICI、ベルギーの expat、ポーランドの B2B ryczałt、ギリシャの inbound が対象です。 |
都市のスラッグはケバブケースです(san-francisco、hong-kong)。わからない場合は、まず list_cities を呼び出してください。
接続
最新のクライアントのほとんどは Streamable HTTP に対応しており、インストールは不要です。URL を指定するだけで接続できます。
Claude Code
claude mcp add --transport http cityparity https://mcp.cityparity.com/mcp
Claude Desktop / ChatGPT Desktop
{
"mcpServers": {
"cityparity": {
"url": "https://mcp.cityparity.com/mcp"
}
}
}
Claude Desktop の設定ファイルは ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または %APPDATA%\Claude\claude_desktop_config.json(Windows)にあります。ChatGPT Desktop は …/OpenAI/ChatGPT/mcp.json を使用します。編集後にアプリを再起動してください。
Cursor
{
"name": "cityparity",
"url": "https://mcp.cityparity.com/mcp"
}
Codex CLI
mcpServers:
cityparity:
url: https://mcp.cityparity.com/mcp
Stdio のみ対応するクライアント(このパッケージ)
クライアントがまだ HTTP MCP に対応していない場合、このリポジトリの npm パッケージが stdio から HTTP へのブリッジとして機能します。
{
"mcpServers": {
"cityparity": {
"command": "npx",
"args": ["-y", "cityparity-mcp"]
}
}
}
ブリッジ(このパッケージ)
cityparity-mcp は約150行の stdio→HTTP フォワーダーです。標準入力から行区切りの JSON-RPC を読み込み、各行を MCP エンドポイントに POST し、レスポンスを標準出力に書き戻します(SSE を1行ずつストリーミングします)。役割はこれだけです。データも計算エンジンも秘密情報もありません。確認したい場合は bin/cityparity-mcp.mjs をご覧ください。
npm install -g cityparity-mcp # or use npx, as above
| 環境変数 | デフォルト | 用途 |
|---|---|---|
CITYPARITY_MCP_URL | https://mcp.cityparity.com/mcp | 上流エンドポイントを上書きします(ローカル開発用) |
CITYPARITY_MCP_DEBUG | 未設定 | リクエスト/レスポンスのフレーミングを標準エラー出力に記録します |
テストを実行します(依存関係ゼロ、Node ≥ 20)。
npm test
算出方法
税金、費用、保育補助、社会保障制度のスコアリングの算出方法を含む詳細な方法論は、ホームページに掲載されています。特に注意していただきたい点は、RSU 収入は入力対象ではありません。 株式報酬は通常、雇用主が変わると引き継げないため、移住元でのみ得られるものとして扱います。米国の雇用主のもとでリモート勤務を続ける場合、その方向での結果はあくまで目安としてご利用ください。
プライバシー
クエリが送信されるのは mcp.cityparity.com のみです。アカウントは不要で、クライアント側のテレメトリーもありません。標準的な HTTP サーバーログを除き、個人を特定できる情報は記録されません。
ライセンス
MIT。cityparity の基盤となるデータと計算エンジンは、このパッケージには含まれていません。このリポジトリは、公開 MCP インターフェースとオープンソースの stdio ブリッジです。
バグを見つけた場合や、都市の追加を希望する場合は、こちらをご覧ください。https://cityparity.com/contact/
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。