mtk-online-mcp

# MTK Online MCP 通过 Playwright 登录 [MTK Online](https://online.mediatek.com/)，在 Cursor 中通过 MCP 抓取页面、按约定优先级搜索，并在用户确认后下载 DCC PDF。 ## 模型 / 助手操作规程（必读） 1. **一般内容查询** 优先调用 **`mtk_search_priority`**。服务端按固定顺序返回四类搜索页的可见文本：**FAQ → Quick Start → eCourse → eService**。回答用户时应**优先采用靠前段落**（尤其 FAQ / Quick Start），再视需要引用后面段落。 2. **已知 FAQ 编号** 使用 **`mtk_fetch_faq_detail`**（`faq_id` 可为 `33353` 或 `FAQ33353`；`list_name` 与站点分类一致，默认 `Modem`）。 3. **DCC 文档（强制两步）** - **第一步**：仅用 **`mtk_search_dcc`** 展示搜索结果列表（可翻页：`page_index`，每页 10 条）。**不要**在未确认前调用下载。 - **第二步**：用户明确确认目标条目的 **`dcc_id`**（如 `DCC3290136`）和**与页面完全一致的 `document_title`（含 `.pdf`）** 后，再调用 **`mtk_download_dcc_pdf`**，且 **`confirmed` 必须为 `true`**。 若标题与页面不一致，点击下载会失败。 4. **任意 HTTPS 链接** 使用 **`mtk_fetch_page`**。若目标为 `eservice.mediatek.com`，MCP 会在 eService 门户尝试二次登录。 ## 工具一览 | 工具 | 用途 | |------|------| | `mtk_search_priority` | 按 FAQ→Quick Start→eCourse→eService 依次搜索同一关键词 | | `mtk_fetch_faq_detail` | 打开指定 FAQ 详情页 | | `mtk_search_dcc` | 仅在 DCC 中搜索，仅列表、不下载 | | `mtk_download_dcc_pdf` | 用户确认后下载 DCC PDF，可选解密预览 | | `mtk_fetch_page` | 登录后打开任意 URL 并返回正文可见文本 | ## 环境变量 | 变量 | 说明 | |------|------| | `MTK_ONLINE_EMAIL` | 必填，登录邮箱 | | `MTK_ONLINE_PASSWORD` | 必填，密码 | | `MTK_ONLINE_OTP` | 可选，一次性验证码（若登录页需要） | | `MTK_ONLINE_LOGIN_URL` | 可选，默认 `https://online.mediatek.com/` | | `MTK_ONLINE_HEADLESS` | 可选，`0` / `false` 为有头浏览器，默认 headless | | `MTK_ONLINE_TIMEOUT_MS` | 可选，超时毫秒数，默认 `60000` | | `MTK_DCC_DOWNLOAD_DIR` | 可选，DCC PDF 保存目录；未设则用 `%TEMP%\mtk_dcc_downloads` | | `MTK_DOC_PASSWORD` | 可选，加密 PDF 解密密码（也可通过工具参数 `pdf_password` 传入） | 建议在 Cursor 的 MCP 配置 `env` 中写入凭据，或使用系统环境变量。 ## 安装 推荐使用项目内可编辑安装（与 `pyproject.toml` 一致，含 `pypdf`）： ```powershell cd "G:\AI\cursor\mtk online" python -m venv .venv .\.venv\Scripts\Activate.ps1 pip install -e . playwright install chromium ``` 若仅用 `requirements.txt`，安装后请确保已安装 `pypdf`（DCC 解密预览需要）。 ### Playwright 浏览器（所有方式都要做一次） 本机**只需安装一次**…