andyleimc-source

Mdymcp — AI skill for Claude Code

AI community

明道（Mingdao）统一 MCP Server：一次安装，98 个工具（v1 协作 API 50 个 + HAP 网关 48 个），支持 Claude Code / Cursor / Codex / Windsurf / Antigravity / Trae / VS Code 七款 AI IDE.

How to install Mdymcp

This entry records only its repository, not the path inside it, so there is no exact command to give. Open andyleimc-source/mdymcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mdymcp does

明道（Mingdao）统一 MCP Server：一次安装，98 个工具（v1 协作 API 50 个 + HAP 网关 48 个），支持 Claude Code / Cursor / Codex / Windsurf / Antigravity / Trae / VS Code 七款 AI IDE。

Alternatives in AI

AI Guide — 程序员鱼皮的 AI 资源大全 + Vibe Coding 零基础教程，分享 OpenClaw 保姆级教程、大模型玩法（DeepSeek / GPT / Gemini / Claude）、最新 AI 资讯、Prompt 提 11.8k ★
Rb Setup — First-time setup 1.3k ★
Skilldock — SkillDock is an AI skill manager and skill management desktop app for Claude Code, Cursor, Codex, Windsurf, Ge 490 ★

README

mdymcp

⬆️ 已装过的用户升级

**升级程序（推荐这条，绕开 uv 索引缓存偶发不更新）：**
uv tool install --force --refresh mdymcp
（或 `uv tool upgrade mdymcp`；升完重启 IDE / 重开会话。）

0.5.x（v1 token 多机集中刷新）

**单机用户**：升级程序即可，**无需任何改动**（默认仍是本地刷新，全向后兼容）。

**多台机器/服务器共用同一明道账号**：必须切「服务器集中刷新」。原因——多端各自持有 token 各自刷新，明道每次 refresh 都轮换 refresh_token，会把彼此顶成孤儿（`error_code 10101`）。把刷新集中到一台常驻服务器当唯一 owner，其余端只读：在做初始部署的那台跑 `mdymcp-install` 选 `[2] 服务器集中`（或 `mdymcp-server-setup`），其余机器把生成的 `~/.mdymcp/server_token_key` + `.env` 里 4 个 `MD_V1_TOKEN_*` 拷过去（**别在其余机器重新授权**）。详见 [`server/README.md`](server/README.md)。

⚠️ 若某个项目自己的 venv 里也 `import mdymcp`（不是只走全局 binary），那份要单独升： `uv pip install --python <项目>/.venv/bin/python -U mdymcp`。

0.3.0（HAP 改用个人 PAT）— 仍停在 0.2.x 的老用户才需要

0.3.0 起 HAP 改用个人 PAT，不再走旧的 `refresh_token / hap_key`。去生成 PAT（`pat_` 开头），然后任选其一：

省事：重跑 mdymcp-install，走到 HAP 步骤粘进去；
手动：编辑 ~/.mdymcp/.env，删掉 MD_HAP_KEY / MD_HAP_REFRESH_TOKEN / MD_HAP_TOKEN，加上 MD_HAP_PAT=pat_xxx。

一键安装

**macOS / Linux**

curl -LsSf https://raw.githubusercontent.com/andyleimc-source/mdymcp/main/install.sh | sh

**Windows（PowerShell）**

powershell -c "irm https://raw.githubusercontent.com/andyleimc-source/mdymcp/main/install.ps1 | iex"

脚本做三件事：

检测 uv，没装就从官方源装上（uv 会自己拉合适的 Python，你机器上是 3.14 / 3.9 还是没装都没关系）
uv tool install mdymcp
启动 mdymcp-install 交互向导 —— 浏览器 OAuth 拿 v1 凭据 → 自动打开 HAP 个人 PAT 页粘 MD_HAP_PAT → 让你选范围（用户级/项目级/两个都要）+ 编号多选要注册的 IDE → 检测到 Claude Code 时自动安装 mdymcp skill（使用心智 + 故障 SOP）到 ~/.claude/skills/mdymcp/

配置写在 `~/.mdymcp/.env`（Windows: `%USERPROFILE%\.mdymcp\.env`），跨目录都能用。

装完后想重跑：`mdymcp-install`

功能

**明道（Mingdao）统一 MCP Server** —— 一次安装，**98 个工具**：

v1 协作 API（50 个，本地实现）：动态 / 日程 / 私信 / 收件箱 / 群组 / 用户 / 组织 / 个人账户
HAP 网关（48 个，透明代理 api2.mingdao.com/mcp）：应用 / 工作表 / 记录 / 角色成员 / 工作流审批 / 图表 / 选项集 / 知识库 / 地区组织

HAP 工具由远端网关动态提供；具体参数 sch