内容
# 奥瑞恩签证 MCP 服务器
[](https://www.npmjs.com/package/orizn-visa-mcp)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
> 为任何 AI 代理提供即时访问 **39,585 种护照-目的地组合** 的签证要求，支持 **15 种语言**，每个签证包含 **32 个数据点** — 费用、处理时间、照片规格、过境签证、大使馆、逾期罚款、安全建议等。
---
## 工具列表
| 工具 | 认证方式 | 描述 |
|------|------|-------------|
| `check_visa_requirement` | API 密钥 | 完整的签证详情 — 文件、流程、提示、过境、费用、处理天数、照片规格、疫苗接种、保险、逾期罚款、大使馆、安全、健康、远程工作、延期等 |
| `quick_visa_check` | API 密钥 | 快速的签证检查（免签证 / 电子签证 / 需要签证 / 到达时签证 / 电子旅行授权 / 不允许入境） |
| `get_all_destinations` | 密钥（专业版） | 任意护照的所有 199 个目的地 |
| `get_visa_changes` | 密钥（入门版） | 跟踪最近的签证政策变化 |
| `check_transit_visa` | API 密钥 | 过境签证规则 + 前 50 个中转枢纽的免费中转时间（DXB、IST、DOH、SIN 等） |
| `get_coverage_stats` | 免费 | 数据库覆盖统计 |
每个工具描述都告诉代理何时调用它（过境、逾期、照片、疫苗接种等），因此模型可以在无需提示技巧的情况下选择正确的工具。
### `check_visa_requirement` 返回的内容
每个完整的签证回复包含多达 **32 个字段**：
- **核心：** `requirement`、`visa_free_days`、`description`、`documents_required`、`process`、`tips`、`country_info`、`verified`
- **费用和时间：** `visa_fee`（单次/多次入境）、`processing_days`（标准/加急/快速）、`best_apply_period`
- **入境：** `passport_validity_months`、`entry_by_mode`（航空/陆路/海路）、`transit_visa`（每个枢纽的规则）
- **文件：** `photo_specs`（毫米尺寸、背景、眼镜规则）
- **健康和安全：** `vaccinations_required`、`health_requirements`、`insurance_required`、`safety`（安全级别 1-4）
- **罚款和警告：** `overstay_penalty`（罚款、禁令、刑事）、`dual_nationality_warnings`、`stamp_warnings`
- **长期停留：** `remote_work_visa`（数字游民）、`extension_rules`、`minor_rules`
- **大使馆：** `embassy.your_embassy_at_destination`（紧急情况）+ `embassy.visa_application_embassy`（申请地点）
- **历史：** `reciprocity_history`（两国之间的政策变化记录）
不适用于给定护照-目的地组合的信息将被省略（例如，`remote_work_visa`仅在存在数字游民签证时出现）。
---
## 快速入门
### Claude 桌面版
将以下内容添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"orizn-visa": {
"command": "npx",
"args": ["-y", "orizn-visa-mcp"],
"env": {
"ORIZN_API_KEY": "您的 API 密钥"
}
}
}
}
```
### Cursor
将以下内容添加到您的 Cursor MCP 设置：
```json
{
"mcpServers": {
"orizn-visa": {
"command": "npx",
"args": ["-y", "orizn-visa-mcp"],
"env": {
"ORIZN_API_KEY": "您的 API 密钥"
}
}
}
}
```
### Codex 桌面版
OpenAI Codex 桌面版原生支持 MCP。将以下内容添加到您的 Codex MCP 配置：
```json
{
"mcpServers": {
"orizn-visa": {
"command": "npx",
"args": ["-y", "orizn-visa-mcp"],
"env": {
"ORIZN_API_KEY": "您的 API 密钥"
}
}
}
}
```
### Composio
[Composio](https://composio.dev) 通过 MCP 将 AI 代理连接到 500+ 工具。使用 Composio 的 MCP 支持访问 Orizn Visa：
```json
{
"mcpServers": {
"orizn-visa": {
"command": "npx",
"args": ["-y", "orizn-visa-mcp"],
"env": {
"ORIZN_API_KEY": "您的 API 密钥"
}
}
}
}
```
### 任意 MCP 客户端
```bash
npx orizn-visa-mcp
```
或使用 API 密钥：
```bash
npx orizn-visa-mcp --api-key 您的密钥
```
---
## 配置
| 选项 | 描述 |
|--------|-------------|
| `ORIZN_API_KEY` 环境变量 | 通过环境变量设置您的 API 密钥 |
| `--api-key` 命令行参数 | 将您的 API 密钥作为命令行参数传递 |
**免费套餐** 无需密钥即可使用 — 您可以使用 `quick_visa_check` 和 `get_coverage_stats`。
在 **[visa.orizn.app](https://visa.orizn.app)** 获取您的 API 密钥
---
## 示例
只需用自然语言询问您的 AI 代理：
**基本检查**
- *"我从法国到泰国旅行需要签证吗？"*
- *"显示巴西护照的所有免签证国家。*"
- *"作为美国公民访问中国需要什么文件？*"
**中转和过境**
- *"如果我是印度人，在迪拜转机是否需要过境签证？*"
- *"如果我持有中国护照，在伊斯坦布尔中转 12 小时是否可以离开机场？*"
**费用和时间**
- *"申根签证的费用是多少，适用于菲律宾护照持有者？*"
- *"目前美国旅游签证的处理时间是多少？*"
**健康和保险**
- *"进入巴西需要接种哪些疫苗，持有法国护照？*"
- *"申根地区要求的最低旅行保险覆盖范围是多少？*"
**文件和照片**
- *"中国签证申请的照片规格是什么？*"
- *"进入越南我的护照需要有效多久？*"
**罚款和规则**
- *"如果我的泰国签证逾期 3 天，罚款是多少？*"
- *"如果我的护照上有以色列印章，是否有入境限制？*"
**长期停留和远程工作**
- *"葡萄牙是否有数字游民签证，费用是多少？*"
- *"可以在泰国境内延长泰国旅游签证吗？*"
**最近的变化**
- *"印度护照持有者的签证政策最近有变化吗？*"
---
## 支持的语言
| 代码 | 语言 |
|------|----------|
| `zh` | 中文 |
| `en` | 英语 |
| `fr` | 法语 |
| `es` | 西班牙语 |
| `de` | 德语 |
| `it` | 意大利语 |
| `pt` | 葡萄牙语 |
| `ru` | 俄语 |
| `ja` | 日语 |
| `ko` | 韩语 |
| `ar` | 阿拉伯语 |
| `hi` | ヒンディ语 |
| `th` | 泰语 |
| `vi` | 越南语 |
| `tl` | Filipino |
---
## 签证类型
| 类型 | 描述 |
|------|-------------|
| `visa_free` | 无需签证 |
| `visa_required` | 必须事先获得签证 |
| `e_visa` | 可在线申请电子签证 |
| `visa_on_arrival` | 在入境口岸发放签证 |
| `eta` | 电子旅行授权 |
| `no_admission` | 不允许入境 |
---
## 定价
| 计划 | 价格 | 每月请求数 |
|------|-------|----------------|
| **免费** | $0 | 有限 |
| **入门版** | $49/mo | — |
| **专业版** | $199/mo | — |
| **商业版** | $699/mo | — |
| **企业版** | 自定义 | 无限 |
在 **[visa.orizn.app](https://visa.orizn.app)** 查看完整计划详情
---
## 链接
- **API 文档** — [visa.orizn.app/visa-api/dashboard/docs](https://visa.orizn.app/visa-api/dashboard/docs)
- **GitHub** — [github.com/MattJeff/orizn-mcp-server](https://github.com/MattJeff/orizn-mcp-server)
- **支持** — [api@orizn.app](mailto:api@orizn.app)
---
## 反馈
正在构建旅行代理或签证工具？我们很乐意听到您在构建什么。
→ **api@orizn.app** — 欢迎提出功能请求、合作伙伴关系和问题。
## 许可证
MIT
