mingdao-mcp-login

通过 HAP OAuth 应用授权，生成个人权限的 MCP JSON；必要时引导浏览器 OAuth。触发词：配置/更新 HAP MCP、明道 MCP、个人 MCP、Bearer、账号密码接入 HAP。

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/garfield-bb/hap-oauth-mcp --skill mingdao-mcp-login

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

name	mingdao-mcp-login
description	通过 HAP OAuth 应用授权，生成个人权限的 MCP JSON；必要时引导浏览器 OAuth。触发词：配置/更新 HAP MCP、明道 MCP、个人 MCP、Bearer、账号密码接入 HAP。

账号：邮箱或手机号；大陆手机用 +8613…，勿只填 11 位。
密码：不在对话里复述；优先用环境变量 MINGDAO_ACCOUNT / MINGDAO_PASSWORD（见 README.md）。
环境：默认 HAP SaaS；固定域名、官方集成应用 id、接口路径见 docs/reference.md（勿把 id 写进本 skill 正文）。

执行脚本时 --oauth-app-id 仍必填：从 docs/reference.md 取 SaaS 官方个人 MCP 的固定 id。

先安装依赖（任选其一）：

bash scripts/install.sh

或：pip install -e .（需 Python 3.10+）；或 pip install -r requirements.txt 后仅用 python3 -m mingdao_mcp_login.*（无需 editable 安装）。

1. 生成（优先）

.venv/bin/md-generate-mcp-config \
  --account "<账号>" --password "<密码>" --oauth-app-id "<集成应用id>" \
  --skip-wait

未用 venv 时：python3 -m mingdao_mcp_login.generate_mcp_config（参数相同）。

2. 只要授权链接时

.venv/bin/md-mingdao-login --account "..." --password "..." --oauth-app-id "..."

或：python3 -m mingdao_mcp_login.md_login（参数相同）。

从输出取 oauth2Url；授权完成后再跑 1。

给用户的内容

stdout 的 JSON 原样放在代码块里，便于一键复制；成功时顶层 key 默认为 HAP Personal MCP（脚本 --mcp-key，可用环境变量 MINGDAO_MCP_KEY 覆盖）。
少说背景：一两句即可，例如「已生成个人 MCP 配置，粘贴到 MCP 客户端」；不要展开流程说明、不要复述命令参数细节。交付后可补一句：Token 会过期，下次要刷新时告诉我——不要补充环境变量示例、docs/reference.md、改密等。
不要写进回复：集成应用 id、OAuth 应用 id、具体 Bearer / token 片段（JSON 里不可避免的 URL 除外，那是交付物本身）；id 只从 docs/reference.md 读取供执行脚本，对用户用「官方个人 MCP 集成」等泛指即可。
结构：优先「短说明 + JSON」；需要步骤时再列 1～3 条，避免长段落与重复句。
排版：非必要不用粗体；列表适度，便于扫读。

参数与退出码见根目录 README.md。