easyonward

EasyOnward MCP 服务

一个只读的 Model Context Protocol 服务，可让任何兼容 MCP 的 AI 助手（Claude Desktop、Cursor、ChatGPT 桌面版等）查询某个国家/地区组合的护照签证、入境和过境要求，并提供官方政府来源以及指向完整 EasyOnward 分析的深层链接。

它封装了 EasyOnward 公开且无需身份验证的签证组合接口。它是只读的，不会发送个人身份信息（PII），也无需 API 密钥。

这不是法律或移民建议。 结果是针对护照签发国任何公民的一般性分析。出行前，务必向航空公司和目的地主管部门核实。

工具

check_visa

查询持有指定护照的旅客前往某个目的地是否需要签证，以及适用哪些入境和过境要求，并提供官方政府来源。

输入

字段	描述
passport_country	旅客的护照签发国。ISO 3166-1 alpha-2 代码（US）或名称（United States）。
destination_country	目的地国家/地区。ISO 3166-1 alpha-2 代码（KE）或名称（Kenya）。

输出 — 包含易读文本和结构化对象：

• verdict — 一行通俗易懂的摘要（受限 / 有条件 / 简单）。
• worst_severity — BLOCK | WARN | INFO | NONE。
• requirements[] — 每项标记的要求，包含 severity、title、detail。
• official_sources[] — 去重后的官方政府来源 URL。
• deep_link — 指向完整分析的 https://easyonward.com/visa/{ORIGIN}-{DEST}。
• prepare_link — 同一页面，附带 ?ref=mcp 标签；除官方/免费途径外，还可比较签证服务、旅行保险和 eSIM 选项。
• disclaimer — 免责声明。

country_code

辅助工具，可将国家/地区名称（或现有的 ISO-2 代码）转换为大写的 ISO 3166-1 alpha-2 代码，例如 Kenya → KE。可在调用 check_visa 前使用。

示例

使用 { "passport_country": "US", "destination_country": "KE" } 调用 check_visa：

Travel from United States to Kenya is conditional — see requirements.

Requirements:
  [INFO] US travel advisory: Kenya — Level 2 (Exercise Increased Caution) — …
  [INFO] Be ready to show proof of funds for Kenya (KE) — …
  [WARN] An electronic travel authorization (eta) for Kenya on your United States (US) passport — …

Official government sources:
  - https://www.etakenya.go.ke
  - https://immigration.go.ke
  - https://travel.state.gov/…/kenya-travel-advisory.html
  …

Full details: https://easyonward.com/visa/US-KE

Generic analysis for any United States citizen. Not legal or immigration advice — verify with
your airline and the destination's authorities before travel.

安装和运行

有两种连接方式，使用相同的工具：

• 托管（远程） — 无需安装，也无需运行任何程序。将任何支持 HTTP 的 MCP 客户端指向 https://mcp.easyonward.com/mcp（Streamable HTTP）。适合大多数用户。
• 本地（stdio） — 通过 npx 在 Node 18+ 上运行（无需安装）：

  npx -y @easyonward/mcp-server
  

  服务通过 stdio 提供 MCP。适合离线/隔离环境，或不支持远程传输的客户端。

托管（远程）— Claude Code / 任意 HTTP 客户端

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

或者，在支持远程服务的客户端配置中：

{
  "mcpServers": {
    "easyonward": {
      "type": "streamable-http",
      "url": "https://mcp.easyonward.com/mcp"
    }
  }
}

托管服务为只读、无状态且不涉及 PII，与本地版本提供相同的两个工具。

Claude Desktop（本地 stdio）

添加到 claude_desktop_config.json （macOS：~/Library/Application Support/Claude/claude_desktop_config.json， Windows：%APPDATA%\Claude\claude_desktop_config.json）：

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

重启 Claude Desktop，然后询问：“我从 US 飞往 Kenya 需要签证吗？”

Cursor

添加到 ~/.cursor/mcp.json（或 Settings → MCP → Add new server）：

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

Smithery

此服务包含 smithery.yaml 清单，因此可从 Smithery 注册表安装：

npx -y @smithery/cli install @easyonward/mcp-server --client claude

Windsurf、Cline 和其他 stdio 客户端

任何支持本地 stdio MCP 服务的客户端都使用同一配置块 — command: npx、args: ["-y", "@easyonward/mcp-server"]。在 Windsurf 中，路径为 Settings → Cascade → MCP Servers；在 Cline 中，则为 MCP 设置 JSON。无需针对特定客户端进行配置。

配置

环境变量	默认值	用途
EASYONWARD_API_BASE	https://easyonward.com/api/v1	API 基础 URL。测试时可指向开发或预发布主机。

示例（指向开发主机）：

{
  "mcpServers": {
    "easyonward": {
      "command": "npx",
      "args": ["-y", "@easyonward/mcp-server"],
      "env": { "EASYONWARD_API_BASE": "https://dev.easyonward.com/api/v1" }
    }
  }
}

安全与隐私

• 只读。 此服务仅对公开的 EasyOnward API 执行 GET 查询，不会写入、预订或修改任何内容。
• 无机密信息，无身份验证。 无需配置 API 密钥或令牌，因此没有信息会泄露。
• 无个人身份信息。 仅发送护照签发国和目的地国家／地区（ISO-2 代码 或国家／地区名称）。不会请求或传输护照号码、姓名、出生日期或任何个人数据。
• 仅限公开数据。 返回的全部内容都是公开的签证／入境／过境参考信息，并附有官方政府来源链接。
• 故障安全。 API 无法访问或国家／地区组合未收录时，会返回清晰的提示，而非崩溃。请求受公共 API 的速率限制约束。

开发

npm install      # install deps
npm run build    # tsc -> dist/
npm test         # unit tests (mocked fetch)
npm start        # run the built server on stdio

此软件包位于独立目录中，与 EasyOnward 前端／后端工具和 CI 刻意隔离。

许可证

MIT