内容
<img src="assets/logo.svg" alt="Everway" width="64" height="64">
# Everway MCP 服务器
**适用于 [Everway](https://everway.ai) 的官方模型上下文协议（MCP）服务器 — 将 Cursor、Claude、ChatGPT 或任何 MCP 客户端连接到您的实际行程和行程安排。**
[](https://modelcontextprotocol.io)
[](#authentication)
[](https://everway.ai)
Everway 将转发的确认邮件转换为每日行程安排。该 MCP 服务器是您的 Everway 账户与支持 MCP 的 AI 工具之间的托管桥梁：连接后，您的助手可以读取您的行程安排，回答有关您的计划的问题，并添加或更新预订 — 所有操作均在您的权限下进行，无需触及您的收件箱。
**服务器 URL**
```
https://everway.ai/api/mcp
```
## 一键设置
| [<img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="添加到 Cursor" height="32">](https://cursor.com/en/install-mcp?name=Everway&config=eyJ1cmwiOiJodHRwczovL2V2ZXJ3YXkuYWkvYXBpL21jcCJ9) | [](https://vscode.dev/redirect/mcp/install?name=Everway&config=%7B%22url%22%3A%22https%3A%2F%2Feverway.ai%2Fapi%2Fmcp%22%2C%22type%22%3A%22http%22%7D) |
| --- | --- |
| 从 Cursor 询问您的行程并添加预订。 | 通过 GitHub Copilot 读取和更新行程安排。 |
对于其他客户端，请使用上述 URL 添加远程 MCP 服务器。浏览器登录处理其余部分 — 无需生成、复制或轮换 API 密钥。
## 支持的客户端
Everway 与任何支持通过可流式 HTTP 与 OAuth 连接的远程 MCP 服务器的客户端配合使用，包括：
| 客户端 | 设置参考 |
| --- | --- |
| Cursor | [Cursor MCP 文档](https://cursor.com/docs/context/mcp) |
| Claude (Claude.ai, Desktop, 和 Code) | [Claude MCP 文档](https://code.claude.com/docs/en/mcp) |
| OpenAI ChatGPT | [连接器 / MCP 指南](https://platform.openai.com/docs/guides/tools-connectors-mcp) |
| Visual Studio Code (GitHub Copilot) | [VS Code MCP 文档](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) |
| Google Gemini CLI | [Gemini CLI MCP 文档](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) |
### 手动配置
```json
{
"mcpServers": {
"everway": {
"url": "https://everway.ai/api/mcp"
}
}
}
```
此存储库还附带了一个适用于 Claude Code 的 [.mcp.json](./.mcp.json) 和适用于 [MCP 注册表](https://modelcontextprotocol.io/registry) 的 [server.json](./server.json) 清单。
## 插件和扩展
除了原始服务器 URL 外，该存储库还将 Everway 打包为客户端支持的插件 — 每个插件都将 MCP 连接与[技能](#skills)捆绑在一起。
**Claude 代码**
```
/plugin marketplace add everway-ai/everway-mcp-server
/plugin install everway@everway
```
**Cursor**
[.cursor-plugin](./.cursor-plugin/plugin.json) 清单将 MCP 服务器和技能打包为 Cursor 插件。您也可以直接添加服务器 URL — 请参阅[一键设置](#one-click-setup)。
**Gemini CLI**
```
gemini extensions install https://github.com/everway-ai/everway-mcp-server
```
## 技能
[`skills/`](./skills/) 目录包含用于人们实际重复的旅行任务的代理技能。支持技能的客户端（Claude Code、Cursor）通过插件清单自动拾取它们。
| 技能 | 功能 |
| --- | --- |
| [`add-bookings-from-text`](./skills/add-bookings-from-text/SKILL.md) | 将粘贴的确认或行程笔记转换为结构化的行程项目。 |
| [`trip-gap-audit`](./skills/trip-gap-audit/SKILL.md) | 查找缺少的内容：空日、未覆盖的夜晚、缺少的转机、没有返回航班。 |
| [`daily-briefing`](./skills/daily-briefing/SKILL.md) | 回答“我在什么地方，我接下来要做什么？”并提供时间、地址和确认号码。 |
| [`trip-budget-report`](./skills/trip-budget-report/SKILL.md) | 按类别、日或旅行者汇总行程费用 — 诚实地报告尚未定价的内容。 |
| [`share-trip`](./skills/share-trip/SKILL.md) | 添加旅行者、发送仅限查看的邀请和管理哪些预订是共享或私有的。 |
## 您可以使用
询问您的行程：
- “我的东京行程还剩下什么需要预订？”
- “周六我的渡轮是什么时间，在哪里出发？”
- “哪些天还没有计划？”
- “到目前为止我的行程总费用是多少？”
或告诉它要做什么：
- “在周五 9 点将我的租车信息添加到里斯本行程中。”
- “将我的酒店退房时间改为第 12 天。”
- “创建一个名为 Amalfi 的行程，时间为 6 月 10 日至 17 日。”
- “邀请 sam@example.com 查看此行程。”
您的助手所做的更改会立即在 Everway 应用程序、地图中以及您共享行程的人员中显示。
## 支持的工具
| 工具 | 功能 |
| --- | --- |
| `get_account` | 已登录的帐户：电子邮件、计划以及是否可以创建另一个行程。 |
| `list_trips` | 用户拥有或被邀请查看的所有行程。 |
| `get_trip` | 单个行程以及用户在其上的角色。 |
| `create_trip` | 创建具有名称和日期的行程。 |
| `update_trip` | 更新行程的名称或日期。 |
| `update_trip_alias` | 更改行程的 @everway.ai 转发地址。 |
| `list_itinerary_items` | 用户可以看到的某个行程中的所有行程项目。 |
| `add_itinerary_item` | 添加航班、住宿、餐厅或活动；地址会自动地理编码。 |
| `update_itinerary_item` | 更新现有的行程项目。 |
| `delete_itinerary_item` | 删除行程项目。 |
| `set_item_visibility` | 与行程共享项目或使其再次私有。 |
| `set_item_people` | 将行程人员附加到项目（乘客、客人、就餐者）。 |
| `list_trip_people` | 行程中的每个人：所有者、客人以及在预订中找到的旅行者。 |
| `add_trip_person` | 将旅行者添加到行程的人员列表中。 |
| `rename_trip_person` | 重命名没有 Everway 帐户的旅行者。 |
| `remove_trip_person` | 从行程及其项目中删除旅行者。 |
| `list_invites` | 行程上的仅限查看邀请及其状态。 |
| `invite_viewer` | 向某人发送仅限查看的行程邀请。 |
| `revoke_invite` | 撤销仅限查看的邀请。 |
编写工具时，请遵守与应用程序相同的规则：仅所有者操作保持仅所有者，免费计划限制适用（免费计划上的第二个行程提示升级而不是静默失败）。
## 认证
服务器使用 **OAuth 2.1 和动态客户端注册**。您的客户端第一次连接时，它会在浏览器中打开 Everway；您使用我们通过电子邮件发送给您的单次代码登录并批准访问。无需密码，无需 API 密钥。
连接范围限定为您的帐户。要断开连接，请从客户端的 MCP 设置中删除 Everway — 访问令牌将在下一个请求中停止工作。
## 数据和安全
- 您的助手充当您，具有您的确切权限：它可以查看和编辑您拥有的行程，并查看与您共享的行程。它无法访问其他人的行程或另一个旅行者的私人预订。
- **无收件箱访问**。Everway 永远不会连接到您的邮箱，您的助手也不会。它只会看到您 Everway 帐户中的行程和行程项目。
- 所有流量都通过 HTTPS 在传输过程中加密。
- 邀请令牌和其他一次性机密永远不会暴露给代理。
MCP 客户端可以使用您的现有权限在 Everway 中执行操作。只需连接您信任的客户端，并在确认之前查看影响深远的更改。有关如何报告漏洞，请参阅 [SECURITY.md](./SECURITY.md)。
## 要求
- 一个 [Everway 帐户](https://everway.ai) — MCP 连接包含在每个计划中，免费和 Pro 计划均有。
- 一个支持远程服务器的 MCP 兼容客户端。
- 一个用于完成 OAuth 登录的浏览器。
## 存储库中包含的内容
服务器作为托管服务运行在 `everway.ai/api/mcp`，并不属于此存储库。这里包含的是公开的部分：
- [`README.md`](./README.md) — 本文档
- [`server.json`](./server.json) — [MCP 注册表](https://modelcontextprotocol.io/registry) 条目
- [`.mcp.json`](./.mcp.json), [`.claude-plugin/`](./.claude-plugin/), [`.cursor-plugin/`](./.cursor-plugin/), [`gemini-extension.json`](./gemini-extension.json) — 客户端清单
- [`skills/`](./skills/) — 用于常见旅行任务的代理技能
- [`scripts/validate-template.mjs`](./scripts/validate-template.mjs) — 验证清单和技能（`node scripts/validate-template.mjs`）
## 支持和反馈
- 产品文档：[everway.ai/mcp](https://everway.ai/mcp)
- 有关托管服务器、登录或帐户的问题：[support@everway.ai](mailto:support@everway.ai)
- 有关此存储库的文档、清单或技能的问题或想法：[打开问题](https://github.com/everway-ai/everway-mcp-server/issues/new/choose)
- 想要贡献？请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md) 和 [行为准则](./CODE_OF_CONDUCT.md)。
## 许可证
此存储库（文档、配置清单和技能）根据 [MIT 许可证](./LICENSE) 许可。Everway 服务本身是专有的 — 请参阅[服务条款](https://everway.ai/terms)。
