From the README

# mingdao-collab-mcp

MCP Server for Mingdao Collaboration-era v1 API.

> **注意：** 本项目封装的是明道**协作时代**的 v1 API，**非**明道云（HAP）零代码平台接口。这些接口在明道转型零代码后仍部分可用，主要覆盖动态、日程、私信、群组、通讯录等协作功能。

## 功能模块

| 模块 | 工具数 | 说明 |
|------|--------|------|
| post | 18 | 动态：发布、评论、点赞、收藏、查询 |
| calendar | 21 | 日程：创建、编辑、邀请、查询（注：日程列表通过 iCal 订阅接口实现，绕过了服务端有 bug 的 get_events_by_conditions 端点） |
| webchat | 8 | 私信/聊天：消息收发、聊天列表 |
| message | 3 | 收件箱：系统消息、动态消息 |
| group | 18 | 群组：创建、管理、成员操作 |
| user | 13 | 用户/通讯录：查找、好友管理 |
| company | 8 | 组织/部门：部门列表、组织查询 |
| passport | 11 | 个人账户：用户详情、设置 |
| task | 7 | 任务：创建、删除、更新状态/名称/截止日期（部分存活） |

共计 **107 个工具**，覆盖 9 个模块。

## 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/user/mingdao-collab-mcp.git
cd mingdao-collab-mcp
```

### 2. 安装依赖

```bash
pip install -e .
# 或者
pip install "mcp[cli]"
```

### 3. 配置凭证

```bash
cp .env.example .env
```

编辑 `.env`，填入你在明道开放平台创建的应用凭证：

```env
MINGDAO_APP_KEY=你的app_key
MINGDAO_APP_SECRET=你的app_secret
MINGDAO_REDIRECT_URI=你的回调地址
```

> 在哪里获取？登录 http