travel_platform_mcp

travel_platform_mcp 是一个面向旅游业务的通用浏览器自动化 MCP Server。它以单一 Python package 分发，通过 FastMCP 暴露 MCP Tool，以 Playwright 执行浏览器任务，并把未知网站探索、脚本生成、测试、Repair 与稳定能力 Promotion 组织成可持续演进的工程体系。

当前架构基线：2026-08-11

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

快速导航

产品入口

推荐安装：

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

升级：

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

临时运行：

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

Host 启动命令保持单一：

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。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

travel_platform_mcp-0.1.0.tar.gz (99.1 kB view details)

Uploaded Aug 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

travel_platform_mcp-0.1.0-py3-none-any.whl (172.8 kB view details)

Uploaded Aug 14, 2026 Python 3

File details

Details for the file travel_platform_mcp-0.1.0.tar.gz.

File metadata

Download URL: travel_platform_mcp-0.1.0.tar.gz
Upload date: Aug 14, 2026
Size: 99.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for travel_platform_mcp-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`c705b9ed87026eb51ee603b52946983b99958da68ffc5185b48a1b8e8033c325`
MD5	`5b8490230d4a87616a82a79cb593ca11`
BLAKE2b-256	`2b6faa0283289828b3ce3f90cd046d89e7c9df50f71c9db3dd0b43d2f5413c7b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for travel_platform_mcp-0.1.0.tar.gz:

Publisher: release.yml on MaojieXu/travel-platform-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: travel_platform_mcp-0.1.0.tar.gz
- Subject digest: c705b9ed87026eb51ee603b52946983b99958da68ffc5185b48a1b8e8033c325
- Sigstore transparency entry: 2464475160
- Sigstore integration time: Aug 14, 2026
Source repository:
- Permalink: MaojieXu/travel-platform-mcp@02ef4931041c68285c0fc7af9f38d3bc3bc63bbb
- Branch / Tag: refs/tags/v0.1.0
- Owner: https://github.com/MaojieXu
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@02ef4931041c68285c0fc7af9f38d3bc3bc63bbb
- Trigger Event: push