Metadata-Version: 2.4
Name: travel-platform-mcp
Version: 0.2.7
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-Dist: pyyaml>=6.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

# README.md

本文说明如何以跨用户、跨操作系统的方式安装并配置 `travel-platform-mcp`。

## 给 Agent 的安装与配置 Prompt

将以下内容完整发送给 Agent：

```text
请为当前用户安装并配置 travel-platform-mcp。请严格按以下步骤执行。

1. 安装 MCP 工具

执行：

uv tool install travel-platform-mcp

若工具已安装，则不要重复安装；请确认该工具可正常执行。

2. 获取 MCP 可执行文件的绝对路径

执行：

uv tool dir --bin

将 MCP 的 command 设置为该目录下的可执行文件：

- Windows：<uv_tool_bin_dir>\travel-platform-mcp.exe
- macOS/Linux：<uv_tool_bin_dir>/travel-platform-mcp

不得硬编码用户名、主目录、磁盘盘符或机器相关路径。

3. 获取模型 API Key

向用户询问模型 API Key。这是唯一必须向用户询问的配置值。

安全要求：

- 不要在日志、最终回复、截图或其他文件中展示或重复 API Key。
- 不要将 API Key 写入项目仓库、config.yaml、.env 或可提交文件。
- 仅将 API Key 写入 MCP 配置的 env.TRAVEL_PLATFORM_MODEL_API_KEY。

4. 查找 Agent Skills 目录

查找当前 Agent/Codex 使用的 Skills 根目录，并获取其绝对路径。

- 优先从当前 Agent 的已有配置中检测。
- 如无法可靠检测，才向用户询问。
- 不要创建、删除、迁移或覆盖该目录中的 Skills。
- 将最终绝对路径写入 MCP 配置的 env.TRAVEL_PLATFORM_SKILLS_DIRECTORY。

5. 创建浏览器独立 Profile 目录

获取当前用户“桌面”目录的绝对路径，不得假定用户名或硬编码 C:\Users\123。

在桌面目录下创建 product_quality_compare 文件夹。若目录已存在，保留其已有内容，不删除、不覆盖。

得到该目录的绝对路径：

<当前用户桌面绝对路径>\product_quality_compare

该目录仅供 travel-platform-mcp 的浏览器实例保存登录状态和运行数据使用。

安全要求：

- 不要读取、输出、迁移或复制用户默认 Chrome、Edge 或 Brave Profile 中的 Cookie、密码、Token 或其他敏感数据。
- 不需要直接启动浏览器。
- 将第 5 步创建的目录绝对路径写入 MCP 配置的 env.TRAVEL_PLATFORM_BROWSER_PROFILE_DIR。

6. 更新 MCP Host 使用的 mcp.json

找到当前 MCP Host 实际使用的 mcp.json，并创建或更新 mcpServers.travel-platform-mcp。

保留 mcpServers 中已有的其他 MCP 配置；不得覆盖或删除它们。

最终条目应符合以下结构。所有路径必须替换成当前用户实际的绝对路径；Windows JSON 路径中的反斜杠必须正确转义：

{
  "mcpServers": {
    "travel-platform-mcp": {
      "command": "<uv_tool_bin_dir>\\travel-platform-mcp.exe",
      "env": {
        "TRAVEL_PLATFORM_MODEL_API_KEY": "<用户提供的模型 API Key>",
        "TRAVEL_PLATFORM_SKILLS_DIRECTORY": "<Agent Skills 根目录绝对路径>",
        "TRAVEL_PLATFORM_BROWSER_PROFILE_DIR": "<当前用户桌面绝对路径>\\product_quality_compare"
      },
      "disabled": false
    }
  }
}

macOS 或 Linux 时，command 使用：

<uv_tool_bin_dir>/travel-platform-mcp

env 中只配置以下三项：

- TRAVEL_PLATFORM_MODEL_API_KEY
- TRAVEL_PLATFORM_SKILLS_DIRECTORY
- TRAVEL_PLATFORM_BROWSER_PROFILE_DIR

7. 完成后进行安全检查并报告

确认：

- travel-platform-mcp 已通过 uv tool 安装且可执行；
- 浏览器 Profile 目录已创建；
- mcp.json 已成功更新且 JSON 格式合法；
- 已保留其他 MCP Server 配置；
- MCP 配置中只注入上述三个 travel-platform-mcp 环境变量。

最终只报告：

- 安装是否成功；
- mcp.json 是否更新成功；
- MCP command 路径；
- Skills 目录路径；
- 浏览器 Profile 目录路径。

不得显示、复述或记录 API Key、Cookie、Token、密码或其他敏感数据。
```

## 更新到最新版本

已通过 `uv tool install` 安装后，使用以下命令将 `travel-platform-mcp` 升级到当前可获得的最新版本：

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

升级完成后重启 MCP Host，使其重新加载更新后的可执行文件。若要确认安装状态，可执行：

```powershell
uv tool list
```
