Transita

@transita/mcp-server

为 Claude、ChatGPT、Cursor、Cline、Zed 及其他 MCP 客户端提供来自 Transita 的签证资格和移民数据。

询问助手“我应该搬去哪里？”，它就会根据你的个人资料核查 16 个国家的 100 多种签证，比较不同途径，并告诉你某个项目目前是否开放。每个回答都会链接到官方政府来源。

此软件包不存储任何数据，而是调用 Transita 公共 API，因此 transita.app 重新部署后，签证变更会立即生效。无需 API 密钥，也无需账户。

有两种连接方式：

• 托管方式： https://transita.app/api/mcp（Streamable HTTP，无需身份验证）。无需安装。
• 本地方式： npx -y @transita/mcp-server（stdio）。需要 Node 20 或更高版本。

安装

Claude Code

托管方式：

claude mcp add --transport http transita https://transita.app/api/mcp

本地方式：

claude mcp add transita -- npx -y @transita/mcp-server

添加 --scope user，即可在每个项目中使用。运行 /mcp 检查连接是否成功。

Claude Desktop 和 claude.ai

托管方式：在 claude.ai/customize/connectors 添加自定义连接器，并填写 URL https://transita.app/api/mcp。它也会显示在 Claude Desktop 中。

本地方式：在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json，或在 Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json，然后重启 Claude Desktop。

{
  "mcpServers": {
    "transita": {
      "command": "npx",
      "args": ["-y", "@transita/mcp-server"]
    }
  }
}

ChatGPT

ChatGPT 只能连接远程服务，因此请使用托管端点。在 ChatGPT 设置中开启开发者模式，创建新的连接器，将 https://transita.app/api/mcp 粘贴为服务 URL，并选择“No authentication”。开发者模式仅适用于部分付费套餐，而且 OpenAI 经常调整菜单位置；如果找不到，请查看他们的帮助页面。

Cursor

将以下内容添加到 ~/.cursor/mcp.json（适用于所有项目），或 .cursor/mcp.json（适用于单个项目）：

{
  "mcpServers": {
    "transita": {
      "url": "https://transita.app/api/mcp"
    }
  }
}

若要使用本地版本，请将 url 行替换为 "command": "npx", "args": ["-y", "@transita/mcp-server"]。

Cline、Continue、Zed 及其他客户端

任何支持 stdio 命令的客户端都可以使用 command: npx 和 args: ["-y", "@transita/mcp-server"]。支持 Streamable HTTP 的客户端则可以改用 https://transita.app/api/mcp。

工具

工具	功能
transita_match_visas	根据个人资料（国籍、学历、工作年限、收入、目标、时间安排）为每种签证评分，并返回最匹配的签证；评分为估算值。
transita_visa_details	查看某种签证的完整信息：资格要求、处理时间、费用、有效期、取得永久居留权的途径，以及文件清单预览。
transita_compare_visas	并排比较 2 或 3 种签证，指出哪种办理最快、费用最低、有效期最长，以及哪种可以通往永久居留权。
transita_country_overview	快速了解目的地：签证数量、欧盟成员身份、评分、缺点、主要城市及租金范围，以及永久居留权和公民身份所需时间。
transita_search_by_nationality	查找某个国家公民可前往的目的地和推荐签证。适用于有人询问“我可以搬去哪里？”，但只知道自己的国籍时。
transita_programme_status	查询某种签证目前是否接受申请。对于 Express Entry 等分轮次项目，还会提供上一轮的日期和分数线。

所有工具均为只读：它们声明 readOnlyHint: true、destructiveHint: false、idempotentHint: true 和 openWorldHint: false。不会存储任何信息，也不会代你发送任何内容；无需账户或 API 密钥。

资源

• transita://visas：所有有效签证
• transita://countries：提供签证的目的地国家及签证数量
• transita://nationalities：国籍指南
• transita://nationality/<slug>：单个国籍指南，例如 transita://nationality/indian

提示词

• find-my-visa：询问一些资格相关问题，然后调用 transita_match_visas
• compare-options：针对你选择的签证运行 transita_compare_visas
• where-should-i-move：从你的国籍出发，探索合适的目的地

示例问题

• “我是一名印度软件工程师，拥有硕士学位和 5 年工作经验。我应该搬去哪里？”
• “比较美国的 O-1A、德国的 EU Blue Card 和葡萄牙的 D8。哪一种能让我最快获得永久居留权？”
• “加拿大的 Express Entry 现在开放申请吗？最近一次的分数线是多少？”
• “葡萄牙的 D8 数字游民签证有什么要求？”

配置

仅适用于本地软件包。

环境变量	默认值	用途
TRANSITA_API_URL	https://transita.app	API 基础 URL。本地开发时，将其指向 http://localhost:3000。
TRANSITA_MCP_USER_AGENT	transita-mcp-server/<version>	每次 API 请求中发送的 User-Agent。

免费与付费

服务返回的所有内容均免费。完整的文件清单和 30 天行动计划属于 Transita 的付费计划，位于 https://transita.app/path/<id>。工具结果包含清单预览和完整计划的链接。

开发

git clone https://github.com/snenenenenenene/transita-mcp-server.git
cd transita-mcp-server
bun install
bun run build

使用本地 Transita 开发服务运行：

TRANSITA_API_URL=http://localhost:3000 node dist/cli.js

从命令行进行冒烟测试：

{
  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0"}}}'
  echo '{"jsonrpc":"2.0","method":"notifications/initialized"}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
} | node dist/cli.js

发布

软件包托管在 npm 上，MCP Registry 中则保存 server.json 元数据。首先更新 package.json、server.json 中的两个 version 字段、src/server.ts 和 src/api.ts 中的版本号。

构建并发布到 npm：

bun run build
npm publish --access public

将源代码推送到公开镜像：

./sync-mirror.sh

发布元数据。先使用 Homebrew 安装发布工具。

mcp-publisher login github
mcp-publisher publish

许可证

MIT，详见 LICENSE。

链接

• 网站：https://transita.app
• MCP 页面：https://transita.app/mcp
• 源代码（公开镜像）：https://github.com/snenenenenenene/transita-mcp-server
• MCP Registry 名称：io.github.snenenenenenene/transita-mcp-server
• Model Context Protocol：https://modelcontextprotocol.io