ImmigrationDB

io.github.streltcoffv0.3.0更新于 Oct 10, 2026

Read-only migration data: cities, visa routes, entry rules, costs, safety, climate, with sources.

已验证Streamable HTTP可网页运行Location & LifestyleData & Analytics

概览

AI 生成的概览

只读移民参考数据：查询国家与城市、签证与居留途径、护照入境规则、生活成本、安全与气候，均附来源。

功能
这是一个托管、只读的 MCP 服务器，基于 ImmigrationDB 这一带来源的移民参考资料，覆盖 39 个国家和 27,000 多个城市。工具可搜索目的地、解析城市名称、获取单个城市或单条城市事实、按兼容指标比较城市，并对城市事实做数值筛选。还可返回国家记录、签证与居留途径、护照入境规则和已发布报告，以及指标与指标分组列表。每个数值都带有来源、观测日期和地理粒度，未知值会明确标注而不会估算。
适用场景
当助手需要关于移居或出国的有来源答案时使用：比较城市的生活成本、薪资、犯罪率、空气质量或气候，查询签证与居留途径，或核对护照入境规则。适合重视数据出处、且不希望助手凭空编造数字的研究与规划场景。
运行要求
远程 Streamable HTTP 端点；未声明需要密钥、账号或环境变量。任何支持 Streamable HTTP 的 MCP 客户端均可连接；仅支持 stdio 的客户端可通过 mcp-remote 接入。需要网络访问，且按客户端有速率限制和响应大小上限。
安装前请注意
所有工具都标注为只读且幂等，不会写入、发送或删除数据。数据是带来源和日期的参考资料，不构成法律建议；入境规则和签证途径可能变化，行动前请核对官方来源。查询内容会发送到该托管服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ImmigrationDB，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

ImmigrationDB MCP

Read-only Model Context Protocol server for ImmigrationDB, a sourced migration reference: 39 countries and 27,000+ cities, visa and residence routes, passport entry answers, cost of living, salaries, crime, air quality and climate. Every value carries its source, observation date and geographic grain. The server reads the same release as the website.

  • Live endpoint (Streamable HTTP, no key, no account): https://immigrationdb.com/mcp
  • Protocol versions: 2026-07-28, 2025-11-25
  • Docs: https://immigrationdb.com/data/mcp/
  • Tool catalog with input schemas: https://immigrationdb.com/data/mcp/catalog.json
  • Methodology: https://immigrationdb.com/methodology/
  • Agent index: https://immigrationdb.com/llms.txt

This repository holds the public contract of the hosted server: client configuration, the tool list with input schemas (tools.json), registry metadata (server.json) and a dependency-free smoke test. The service runs only as the hosted endpoint above; its data release is several gigabytes and is published as files at https://immigrationdb.com/data/mcp/.

Tools

ToolArgumentsWhat it does
search_destinationsquery, limit, cursorSearch countries and cities.
resolve_cityquery, limitResolve a city name to ranked candidates; never picks an ambiguous country silently.
get_citycountry, slug, detail, metric_idsOne city with claim-level facts and source metadata.
get_city_factcountry, slug, metric_idExactly one fact: value, unit, grain, dates, source.
compare_citiescities, metric_idsCompare cities on compatible metrics, with provenance for every cell.
search_factscountries, filters, sort_metric, sort_order, limit, cursor, diagnosticNumeric filters over city facts with explicit counts.
list_metricscountry, block, query, comparison_eligible, limit, cursorMetric definitions and their coverage.
list_blockscountry, limit, cursorMetric blocks with coverage.
get_countryccOne country record with official visa-route links.
search_visa_routesdestination, purpose, limit, cursorVisa and residence routes of a destination.
get_legal_routedestination, route_idOne route with its official source.
search_entry_rulespassport, destination, purpose, limit, cursorPassport entry rules; unknown answers stay explicit.
get_entry_rulepassport, destinationOne passport entry rule.
list_reportscategory, limit, cursorPublished reports (largest cities, cheapest rent, cleanest air…).
get_reportreport_idOne report with its rows, method and sources.

Optional arguments are listed with the required ones; tools.json has the full input schemas. Country arguments are ISO 3166-1 alpha-2 codes (de, lv, us); city arguments are canonical slugs (berlin), not display names. All tools are annotated read-only and idempotent.

Resources

  • immigrationdb://country/{cc} — country record and route links
  • immigrationdb://city/{country}/{slug} — city facts with source metadata
  • immigrationdb://legal/routes/{country}/{route_id} — one visa or residence route
  • immigrationdb://legal/entry/{passport}/{destination} — one passport entry answer
  • immigrationdb://legal/entry/{passport} — all entry answers for a passport
  • immigrationdb://report/{report_id} — report rows, method and sources

Client configuration

Any MCP client that supports Streamable HTTP:

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

Claude Code:

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

Clients that only speak stdio can go through mcp-remote: npx -y mcp-remote https://immigrationdb.com/mcp.

Example calls

json
{ "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" } }

Response contract

Every response carries the snapshot ID, its generation date and the canonical origin. Facts keep their value, unit, geographic grain, observation date, verification date, source ID, source URL and grade. Unknown or withheld values are returned as such and never estimated. Errors name the requested identifier and the snapshot ID. Rate limits and response-size caps apply per client.

Smoke test

Node 20 or newer, no install step:

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

License

The files in this repository are MIT. The ImmigrationDB data is published under CC BY 4.0: credit ImmigrationDB and link to the page or resource you used. The underlying official sources keep their own terms; each value names its publisher and links to it.

ImmigrationDB is an independent reference. It gives no legal advice and sells no visa or immigration services; check current requirements with the responsible authority before acting.

来源：README.md，提交 d578564

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.3.0最新Oct 10, 2026