Token管理工具

明道云 MCP for Claude Code 是一款用于自动管理 Token 刷新的工具,适用于 macOS 系统,通过定时任务确保 access_token 和 refresh_token 的有效性。

  • by andyleimc-source
  • Shell
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 andyleimc-source/mingdao-mcp-setup

使用说明

明道云 MCP for Claude Code

让 Claude Code 通过 MCP 连接明道云,自动管理 Token 刷新。

前提条件

  • macOS
  • Claude Code 已安装
  • curl、jq、python3(macOS 自带或通过 Homebrew 安装)

一键安装

git clone https://github.com/andyleimc-source/mingdao-mcp-setup.git ~/.config/mingdao-mcp && bash ~/.config/mingdao-mcp/setup.sh

按提示输入三个参数:

参数 说明
CLIENT_ID OAuth 客户端 ID(联系管理员获取)
CLIENT_SECRET OAuth 客户端密钥(联系管理员获取)
REFRESH_TOKEN 刷新令牌(通过 OAuth 授权流程获取)

脚本会自动:验证凭据 → 配置 Claude Code MCP → 安装定时刷新任务。

安装完成后:

  • 每 20 小时自动刷新 token(access_token 有效期 24 小时)
  • 开机 / 唤醒后立即刷新
  • 刷新失败会弹出 macOS 通知提醒

卸载

bash ~/.config/mingdao-mcp/install.sh uninstall

手动刷新

bash refresh.sh

Token 有效期

Token 有效期 过期后
access_token 24 小时 自动刷新
refresh_token 14 天 需重新运行 bash setup.sh

如果超过 14 天未开机,refresh_token 会过期,届时会收到 macOS 通知,重新运行 setup.sh 即可。

文件说明

├── setup.sh       # 初始化配置(交互式输入凭据)
├── refresh.sh     # Token 刷新脚本
├── install.sh     # 安装 / 卸载定时任务
├── .env           # 凭据存储(不会被提交到 Git)
├── .gitignore
└── README.md

日志

刷新日志位于项目目录下的 refresh.log。


相关项目

两个项目都解决明道云 MCP token 刷新问题,但适用场景不同:

本项目 hap-token-refresh-daily
运行方式 云端 / 服务器(OAuth + cron) 本机运行(Node.js 代理)
Token 来源 OAuth access_token + refresh_token HAP workflow hook(每日 key)
刷新机制 每 20 小时定时刷新 每天首次使用时刷新
前提条件 macOS、OAuth 凭据 Node.js、account_id + key

如果没有 OAuth 凭据,只有 account_id 和 key,请使用 hap-token-refresh-daily。


关注我

雷码工坊笔记 — 微信扫码关注