ImmigrationDB

ImmigrationDB MCP

为 ImmigrationDB 提供的只读 Model Context Protocol 服务。ImmigrationDB 是一个有来源依据的移民参考数据库，涵盖 39 个国家和 27,000 多个城市，包括签证和居留途径、护照入境信息、生活成本、薪资、犯罪、空气质量和气候。每项数据都附有来源、观测日期和地理粒度。此服务读取的网站数据版本与网站相同。

• 实时端点（Streamable HTTP，无需密钥或账户）： https://immigrationdb.com/mcp
• 协议版本： 2026-07-28、2025-11-25
• 文档： https://immigrationdb.com/data/mcp/
• 包含输入架构的工具目录： https://immigrationdb.com/data/mcp/catalog.json
• 方法： https://immigrationdb.com/methodology/
• Agent 索引： https://immigrationdb.com/llms.txt

此存储库包含托管服务的公开契约：客户端配置、带输入架构的工具列表（tools.json）、注册表元数据（server.json）以及无需依赖的冒烟测试。该服务仅通过上述托管端点运行；其数据版本有数 GB，并以文件形式发布在 https://immigrationdb.com/data/mcp/。

工具

工具	参数	功能
search_destinations	query、limit、cursor	搜索国家和城市。
resolve_city	query、limit	将城市名称解析为排序后的候选项；若国家存在歧义，则不会默默代为选择。
get_city	country、slug、detail、metric_ids	获取单个城市及其主张级事实和来源元数据。
get_city_fact	country、slug、metric_id	获取一项事实：值、单位、粒度、日期和来源。
compare_cities	cities、metric_ids	根据兼容指标比较城市，并为每个单元格提供来源信息。
search_facts	countries、filters、sort_metric、sort_order、limit、cursor、diagnostic	对城市事实应用数值筛选，并提供明确的计数。
list_metrics	country、block、query、comparison_eligible、limit、cursor	列出指标定义及其覆盖范围。
list_blocks	country、limit、cursor	列出指标区块及其覆盖范围。
get_country	cc	获取单个国家记录及官方签证途径链接。
search_visa_routes	destination、purpose、limit、cursor	搜索目的地的签证和居留途径。
get_legal_route	destination、route_id	获取单个途径及其官方来源。
search_entry_rules	passport、destination、purpose、limit、cursor	查询护照入境规定；未知答案会明确标示。
get_entry_rule	passport、destination	获取单条护照入境规定。
list_reports	category、limit、cursor	列出已发布的报告（最大城市、租金最低的城市、空气最清洁的城市等）。
get_report	report_id	获取单份报告及其数据行、方法和来源。

可选参数与必需参数一同列出；tools.json 包含完整的输入架构。国家参数使用 ISO 3166-1 alpha-2 代码（de、lv、us）；城市参数使用规范 slug（berlin），而非显示名称。所有工具均标注为只读且具幂等性。

资源

• immigrationdb://country/{cc} — 国家记录和途径链接
• immigrationdb://city/{country}/{slug} — 城市事实及来源元数据
• immigrationdb://legal/routes/{country}/{route_id} — 单条签证或居留途径
• immigrationdb://legal/entry/{passport}/{destination} — 单条护照入境信息
• immigrationdb://legal/entry/{passport} — 某本护照的所有入境信息
• immigrationdb://report/{report_id} — 报告数据行、方法和来源

客户端配置

任何支持 Streamable HTTP 的 MCP 客户端：

{
  "mcpServers": {
    "immigrationdb": {
      "url": "https://immigrationdb.com/mcp"
    }
  }
}

Claude Code：

claude mcp add --transport http immigrationdb https://immigrationdb.com/mcp

仅支持 stdio 的客户端可以通过 mcp-remote 连接： npx -y mcp-remote https://immigrationdb.com/mcp。

调用示例

{ "tool": "resolve_city", "arguments": { "query": "Berlin, Germany", "limit": 5 } }
{ "tool": "get_city_fact", "arguments": { "country": "de", "slug": "berlin", "metric_id": "population_total" } }
{ "tool": "compare_cities", "arguments": { "cities": [{ "country": "de", "slug": "berlin" }, { "country": "de", "slug": "munich" }], "metric_ids": ["population_total"] } }
{ "tool": "search_facts", "arguments": { "countries": ["de"], "filters": [{ "metric_id": "population_total", "op": ">", "value": 100000 }], "sort_metric": "population_total", "sort_order": "desc", "limit": 20 } }
{ "tool": "get_entry_rule", "arguments": { "passport": "lv", "destination": "us" } }

响应约定

每个响应都包含快照 ID、生成日期和规范来源。事实保留其数值、单位、地理粒度、观测日期、验证日期、来源 ID、来源 URL 和等级。未知或暂不提供的值将如实返回，不会进行估算。错误信息会注明请求的标识符和快照 ID。速率限制和响应大小上限按客户端分别 적용。

冒烟测试

Node 20 或更高版本，无需安装：

node scripts/smoke.mjs                 # initialize, list tools, run six example calls
node scripts/smoke.mjs --write-tools   # also refresh tools.json from the live server

许可证

本仓库中的文件采用 MIT 许可证。ImmigrationDB 数据依据 CC BY 4.0 发布：请注明 ImmigrationDB，并链接到您使用的页面或资源。底层官方来源各自保留其条款；每个值都会注明其发布者并链接到相应来源。

ImmigrationDB 是独立参考资料，不提供法律建议，也不销售签证或移民服务；采取行动前，请向主管部门确认当前要求。