cityparity: Cost-of-Living & Quality-of-Life Comparison

cityparity MCP 服务

AI Agent 可调用的生活成本和生活质量比较工具。指定两个城市，工具即可返回税后收入、完整的成本明细、在目标城市所需的等值薪资，以及人们实际会为了哪些非现金因素搬家：假期、育儿假、全民医保。

托管地址：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	比较两个城市的完整情景：税后收入、成本明细、目标城市等值薪资、生活方式差异和质量评分。
list_cities	按国家分组，查找受支持城市的 slug。
get_city_summary	单个城市概况：税制特点、主要成本和社会保障网价值。
rank_cities	按综合质量评分列出排名靠前的 N 个城市，并支持自定义权重以及地区／国家筛选。
get_safety_net	查询 1 至 20 个城市的育儿假、全民医保标记、假期和公共假日。
get_inbound_tax_regime	查询外来工作者税制：意大利 impatriati、葡萄牙 IFICI、比利时 expat、波兰 B2B ryczałt、希腊 inbound。

城市 slug 使用 kebab-case（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 转发程序。它从 stdin 读取按行分隔的 JSON-RPC，将每行 POST 到 MCP 端点，并将响应写回 stdout（逐行流式传输 SSE）。这就是它的全部工作：不存储数据，不包含计算引擎，也没有机密信息。如需验证，可查看 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	未设置	将请求／响应帧信息记录到 stderr

运行测试（零依赖，Node ≥ 20）：

npm test

方法论

完整的方法论（税费、成本、托儿补贴和社会保障网评分的计算方式）见主页。有一点值得注意：RSU 收入不是输入项。 股权授予仅按来源地计算，因为它们通常不会随你转到其他雇主。如果你远程为美国雇主工作，请将该方向的结果视为参考。

隐私

查询只会发送至 mcp.cityparity.com。没有账户、没有客户端遥测，除标准 HTTP 服务器日志外，不会记录任何个人身份信息。

许可证

MIT。cityparity 的底层数据和计算引擎不属于此软件包。此仓库包含公开的 MCP 接口和开源的 stdio 桥接。

---

发现 Bug 或希望添加某座城市？ https://cityparity.com/contact/