打卡 MCP (mcpcn-checkin-mcp)

一个用于触发飞书和钉钉打卡通知的 MCP 服务器。通过 aido://tool? 协议通知客户端执行实际的打卡操作。

功能特性

• 🏢 支持飞书 (Feishu/Lark) 和钉钉 (DingTalk) 两种打卡平台
• ⏰ 支持上班打卡 (checkin) 和下班打卡 (checkout) 两种操作
• 📡 通过 aido://tool? 协议与客户端通信
• 💻 跨平台支持 (macOS, Windows, Linux)

安装

# 安装依赖
npm install

# 构建项目
npm run build

使用方法

作为 MCP 服务器运行

# 开发模式
npm run dev

# 生产模式
npm start

可用工具

1. checkin - 触发打卡通知

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | platform | string | ✅ | 打卡平台：feishu 或 dingtalk | | action | string | ✅ | 打卡操作：checkin(上班) 或 checkout(下班) |

示例：

{
  "name": "checkin",
  "arguments": {
    "platform": "feishu",
    "action": "checkin"
  }
}

2. list_platforms - 列出支持的平台

无需参数，返回所有支持的平台和操作类型。

工作原理

当调用 checkin 工具时，MCP 服务器会：

1. 验证 platform 和 action 参数
2. 构建打卡信息对象
3. 通过 aido://tool? 协议通知客户端
4. 返回打卡通知结果

协议格式

aido://tool?path={encodedMessage}&chatSessionId={sessionId}&package={packageName}

其中 path 参数包含 JSON 格式的打卡信息：

{
  "platform": "feishu",
  "action": "checkin",
  "timestamp": "2026-02-06T12:00:00.000Z",
  "description": "飞书/Lark - 上班打卡"
}

License

MIT