Metadata-Version: 2.4
Name: travel-platform-mcp
Version: 0.2.4
Summary: 旅行平台本地 MCP 网关
Keywords: mcp,travel,automation,playwright
Author: MAOJIE XU
Author-email: MAOJIE XU <maojiexu16@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Dist: fastmcp==3.4.6
Requires-Dist: playwright>=1.62.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: openai>=1.107.0
Requires-Dist: pydantic-settings>=2.10.0
Requires-Python: >=3.12
Project-URL: Repository, https://github.com/MaojieXu/travel-platform-mcp
Project-URL: Issues, https://github.com/MaojieXu/travel-platform-mcp/issues
Description-Content-Type: text/markdown

# travel-platform-mcp

`travel-platform-mcp` 是面向旅游业务的本地 MCP Server，提供平台初始化、模型配置、Skill 同步及站点自动化能力。

## 快速开始

将以下两段 Prompt 按顺序复制给当前 Agent。第一段完成安装与 MCP 接入；确认连接成功后，
再发送第二段同步内置 Skill。

### Prompt 1：安装并接入 MCP

```text
请安装并接入 travel-platform-mcp：

1. 确认 uv 可用，然后运行：uv tool install travel-platform-mcp。
2. 将 travel-platform-mcp 配置为当前 Agent 的 MCP Server，使用当前 Agent 或 MCP Host 支持的原生配置方式；不要假定特定的 JSON 配置格式。
3. 重载或重启 MCP Host，确认已连接的 travel-platform-mcp MCP Server 可发现 platform.setup、platform.health、platform.configure 和 platform.skills.sync。

不要从 Git 仓库复制源码安装，也不要为该包启动第二个 MCP Server。涉及修改当前 Agent 配置时，先向我说明影响并获得授权。
```

### Prompt 2：同步包内 Skill

```text
连接 travel-platform-mcp MCP Server 后，调用其 platform.skills.sync Tool，将包内全部 Skill 同步到当前 Agent 自己的 Skill 根目录。

先识别当前 Agent 实际 Skill 根目录的绝对路径；不得使用项目源码目录、包内资源目录或其他 Agent 的目录。说明 overwrite: true 会完整替换同名 Skill，并在获得我的覆盖授权后调用：

platform.skills.sync({
  "target_skills_directory": "<当前 Agent 实际 Skill 根目录的绝对路径>",
  "overwrite": true
})

仅当结果返回 status: "ready" 时视为完成，并检查 copied、updated、skipped 与 warnings。确认 travel-platform-initialization/SKILL.md 已存在且可读后，再读取并执行该初始化 Skill。
```

## 升级

```bash
uv tool upgrade travel-platform-mcp
```

升级后重新加载 MCP Host，再让 Agent 执行已同步的 `travel-platform-initialization` Skill。
该 Skill 会在获得授权后覆盖同步内置 Skill，并执行基础健康检查。

## 文档

- [完整文档索引](docs/README.md)：架构、Tool 契约、配置、安全、发布与开发资料。
- [分发与 Agent 集成](docs/06-distribution-and-agent-integration.md)：安装、升级与 MCP Host 接入说明。
- [MCP Tool 与 Provider](docs/02-mcp-tools-and-providers.md)：可用 Tool 的职责与边界。

## 许可证

[Apache License 2.0](LICENSE)
