Metadata-Version: 2.4
Name: travel-platform-mcp
Version: 0.1.0
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==4.0.0b1
Requires-Dist: playwright>=1.62.0
Requires-Dist: httpx>=0.28.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。它以单一 Python package 分发，通过 FastMCP 暴露 MCP Tool，以 Playwright 执行浏览器任务，并把未知网站探索、脚本生成、测试、Repair 与稳定能力 Promotion 组织成可持续演进的工程体系。

> 当前架构基线：2026-08-11
>
> 本文档包由原始单文件架构文档重构而来。主体架构被拆分为 9 个主题文档，并补充了交叉引用、工程约束、失败处理、生命周期门槛和维护规则。补充内容属于对原架构意图的工程化展开，不代表对第三方产品当前 API 的外部核验。

## 快速导航

- [文档索引](docs/README.md)
- [00 — 项目总览与架构原则](docs/00-overview.md)
- [01 — 技术栈、依赖与 CLI 策略](docs/01-technology-stack.md)
- [02 — MCP Tools、Discovery 与 Site Provider](docs/02-mcp-tools-and-providers.md)
- [03 — 代码库架构与 Execution Context](docs/03-codebase-architecture.md)
- [04 — 自动化生命周期：Explore / Codegen / Test / Repair / Promotion](docs/04-automation-lifecycle.md)
- [05 — 安全、权限、配置与 Secret](docs/05-security-and-configuration.md)
- [06 — 分发、升级与 Agent 集成](docs/06-distribution-and-agent-integration.md)
- [07 — 工程治理、CI/CD、运维与指标](docs/07-engineering-and-operations.md)
- [08 — MCP Tool 贡献、Site Provider 与 Subagent 架构](docs/08-tool-contribution-and-subagent-architecture.md)
- [AGENTS.md](AGENTS.md) — coding agent 必须遵守的仓库规则

## 产品入口

推荐安装：

```bash
uv tool install "travel-platform-mcp==0.1.0"
travel-platform-mcp-bootstrap --install-browser
```

升级：

```bash
uv tool upgrade "travel-platform-mcp==0.1.0"
```

临时运行：

```bash
uvx --from "travel-platform-mcp==0.1.0" travel-platform-mcp
```

Host 启动命令保持单一：

```text
travel-platform-mcp
```

首次安装后必须执行 `travel-platform-mcp-bootstrap --install-browser` 下载 Chromium。随后将
`travel-platform-mcp` 注册为 MCP Host 的 stdio 命令；不要将登录凭证写入 Host 配置。

## 一句话架构

> `travel_platform_mcp` 是一个通过 uv 分发和升级、由 FastMCP 4 驱动、可被 OpenClaw、Codex 等 MCP Agent 直接加载的旅游浏览器自动化 MCP Server；FastMCP 负责协议、Tool、Schema、Validation、Provider、Discovery 和 Runtime，Playwright 负责浏览器执行，Pydantic 只维护真正的领域契约，平台自身集中建设 Site Knowledge、Semantic Recording、未知网站探索、脚本沉淀和 Agent Repair。

## 文档阅读顺序

第一次进入项目时，建议按 `00 → 03 → 02 → 04 → 05 → 06 → 07 → 01` 阅读。实现功能时则按职责直接进入对应文档，不应依赖单个超长总文档理解整个系统。

## 许可证

本项目采用 [Apache License 2.0](LICENSE)。
