@jacob2826/openclaw-dida365-mcp

v0.2.3

Published

2 months ago

OpenClaw plugin that exposes official Dida365 MCP tools through mcp-remote.

Downloads

0High
0Medium
0Low

jacob2826

openclaw mcp dida365 ticktick openclaw-plugin

OpenClaw 滴答清单（Dida365）MCP 插件

@jacob2826/openclaw-dida365-mcp 是一个将 滴答清单（Dida365）官方 MCP 直接接入 OpenClaw Agent 工具层的插件。

它的目标很明确：在统一的 Agent 会话中调用滴答清单能力，同时保持工具命名、参数结构和上游官方 MCP 一致，不额外引入一层私有 API，也不依赖专用 Agent 路由。

✨ 特性

直接暴露滴答清单（Dida365）官方 MCP 工具
当前 bundled manifest 已覆盖官方 22 个工具，包含 create_project、update_project
使用官方 tools/list 生成的工具 schema
支持随上游工具集更新而刷新
通过 mcp-remote 连接远端 MCP，并复用单进程内连接
支持通过 npm 包被 OpenClaw 直接安装

兼容性

| 插件版本 | OpenClaw 版本 | npm 包名 | 状态 | | --- | --- | --- | --- | | 0.2.x | >=2026.3.22 | @jacob2826/openclaw-dida365-mcp | 活跃 |

🧭 设计定位

这个项目不是滴答清单的替代实现，也不是“再包一层任务 API”的封装器。
它更像一个薄桥接层：

OpenClaw Agent
-> openclaw-dida365-mcp
-> mcp-remote
-> https://mcp.dida365.com

它解决的是这类问题：

希望在同一个 Agent 会话中直接调用滴答清单（Dida365）能力
希望保持官方工具名，而不是维护一套二次映射
希望插件本身尽量轻，升级路径尽量跟随官方 MCP

🆚 与常见接入方式的区别

围绕滴答清单（Dida365）的 Agent 接入，常见做法通常分成几类：

| 方式 | 常见特点 | 典型问题 | 本项目的选择 | | --- | --- | --- | --- | | 专用 Agent 路由 | 把某类会话整体交给一个任务 Agent | 会话入口被拆分，集成边界较重 | 保持在既有 Agent 工具层接入 | | 自定义工具映射 | 自定义 get_today_tasks、create_project 等私有接口 | 工具名和 schema 容易与上游漂移 | 直接使用官方工具名与 schema | | 一次性脚本封装 | 用零散脚本拼接查询、创建、更新流程 | 可维护性和可测试性较弱 | 使用标准 OpenClaw 插件结构 |

如果你需要的是“稳定复用上游官方 MCP 能力”，而不是“重新设计一套任务抽象层”，这个项目更合适。

📦 MCP 能力概览

截至 2026-04-03，重新从滴答清单（Dida365）官方 MCP 拉取 tools/list 后，当前官方暴露的工具共 22 个；本项目默认按 manifest 全量注册。

下面的分类仅用于文档说明；运行时仍然直接使用官方工具名。

| 抽象分类 | 官方 MCP 工具 | 对应功能 | | --- | --- | --- | | 项目管理 | list_projects | 列出全部项目 | | 项目管理 | create_project | 创建项目 | | 项目管理 | update_project | 更新项目属性 | | 项目管理 | get_project_by_id | 按项目 ID 查看项目详情 | | 项目管理 | get_project_with_undone_tasks | 查看项目及其未完成任务 | | 任务管理 | create_task | 创建任务 | | 任务管理 | update_task | 更新任务内容、时间、字段等信息 | | 任务管理 | get_task_in_project | 获取某个项目中的指定任务 | | 任务管理 | get_task_by_id | 按任务 ID 获取任务详情 | | 任务管理 | complete_task | 标记单个任务完成 | | 任务管理 | complete_tasks_in_project | 批量完成项目中的任务 | | 任务管理 | move_task | 移动任务到其他位置或项目 | | 查询检索 | search_task | 搜索任务 | | 查询检索 | search | 通用搜索 | | 查询检索 | fetch | 按 MCP 服务定义执行抓取类查询 | | 查询检索 | filter_tasks | 按条件筛选任务 | | 时间视图 | list_undone_tasks_by_date | 按日期查看未完成任务 | | 时间视图 | list_undone_tasks_by_time_query | 按时间查询词查看未完成任务 | | 时间视图 | list_completed_tasks_by_date | 按日期查看已完成任务 | | 批量操作 | batch_add_tasks | 批量创建任务 | | 批量操作 | batch_update_tasks | 批量更新任务 | | 账户配置 | get_user_preference | 读取用户偏好设置 |

🚀 安装与启用

先看这个

如果你的 OpenClaw 开了 tools.profile（例如 "coding"）或显式 tools.allow / allowlist，只安装插件还不够；还必须额外放行“可选插件工具”，否则对话里的 Agent 看不到滴答清单 MCP 工具。

最短可用命令：

openclaw plugins install "@jacob2826/openclaw-dida365-mcp"
openclaw config set plugins.entries.openclaw-dida365-mcp.enabled true
openclaw config set tools.alsoAllow '["group:plugins"]' --strict-json
openclaw gateway restart

如果你跳过第 3 行，常见现象就是“插件已安装，但聊天里没有任何滴答清单 MCP 工具可调用”。

1. 通过 OpenClaw 直接安装

openclaw plugins install "@jacob2826/openclaw-dida365-mcp"

如果你需要安装指定版本：

openclaw plugins install "@jacob2826/[email protected]"

2. 启用插件

openclaw config set plugins.entries.openclaw-dida365-mcp.enabled true

3. 把插件工具加入 OpenClaw 的工具策略

这个插件注册的是 optional 插件工具。
如果你的 OpenClaw 配置了 tools.profile（例如常见的 "coding"）或显式 tools.allow，插件虽然已安装启用，但对话里的 Agent 仍然看不到这些滴答清单 MCP 工具。

推荐直接执行下面这条全局配置：

openclaw config set tools.alsoAllow '["group:plugins"]' --strict-json

如果你希望更明确地验证当前配置是否已经生效，可以按这个顺序执行：

openclaw config get tools.alsoAllow
openclaw plugins info openclaw-dida365-mcp
openclaw gateway restart

如果你只想给某个 Agent 放开，也可以在对应 Agent 的工具配置里加：

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "alsoAllow": ["group:plugins"]
        }
      }
    ]
  }
}

4. 如需更细粒度控制，再使用 allowlist

如果你的 Agent 使用了工具 allowlist，请确保把插件 id 加进去。下面的片段只是示意，请在你现有配置基础上合并：

{
  "agents": {
    "main": {
      "tools": {
        "allow": ["openclaw-dida365-mcp"]
      }
    }
  }
}

5. 重启 gateway

openclaw gateway restart

6. 完成 OAuth

首次真实调用工具时，mcp-remote 会触发浏览器登录。完成一次授权后，后续通常会复用本地 token。

⚙️ 配置项

| 配置项 | 默认值 | 说明 | | --- | --- | --- | | serverUrl | https://mcp.dida365.com | 滴答清单（Dida365）MCP 地址 | | command | npx | 启动 mcp-remote 的命令 | | args | ["-y", "mcp-remote@latest"] | 启动参数 | | host | 127.0.0.1 | 本地 OAuth 回调监听地址 | | authTimeoutSeconds | 300 | OAuth 等待时间 | | requestTimeoutSeconds | 300 | MCP 请求超时 | | idleTimeoutSeconds | 600 | 空闲多久后自动关闭内部子进程 | | refreshManifestOnStartup | false | 启动时是否自动刷新 manifest | | manifestPath | data/mcp-tools.json | 自定义 manifest 路径 | | toolAllowlist | [] | 仅注册指定工具 | | toolDenylist | [] | 排除指定工具 |

🔁 连接模型

该插件不会额外引入一个长期常驻服务。

当前行为是：

第一次调用滴答清单（Dida365）工具时拉起 mcp-remote
同一个 OpenClaw 进程内复用同一条连接
默认空闲 600 秒自动关闭
下次调用时自动重连

这样做的目的是在“调用延迟”和“进程常驻成本”之间取得平衡。

需要注意的是：

单进程内连接复用是有保证的
如果你另外启动独立调试进程，它们仍会建立各自的连接

🧪 开发与验证

npm install
npm run build
npm run check
npm test
npm run refresh-tools
npm run verify-basic

其中：

npm test：覆盖配置解析、manifest 处理、连接复用、空闲回收、注册逻辑等
npm run refresh-tools：重新从官方 MCP 拉取 tools/list
npm run verify-basic：做一轮真实基础联通验证，当前覆盖
- list_projects
- list_undone_tasks_by_time_query
- create_task
- complete_task

CI 不执行真实 OAuth 集成测试；需要登录和真实账号数据的验证，仍建议在本地完成。

🔧 常见排障

如果首次拉起 mcp-remote 时只看到模糊的 Connection closed，优先查看 gateway 或插件日志里附带的最近 stderr 摘要。当前版本会把 npx 启动失败的关键上下文一并带出来。

如果日志里出现 npm error code EPERM、Your cache folder contains root-owned files 一类错误，说明问题在 npx / npm cache，而不是 Dida365 OAuth 本身。插件运行时现在会默认给 mcp-remote 使用隔离的 npm cache：

优先使用 OPENCLAW_STATE_DIR/npm
否则回退到 ~/.openclaw/cache/openclaw-dida365-mcp/npm

如果你有自定义 npm cache 管理策略，仍然可以显式设置 NPM_CONFIG_CACHE 或 npm_config_cache 覆盖默认值。

🛡️ 安全边界

当前版本默认具备这些约束：

远程 MCP 只允许 https://
http:// 仅允许本机回环地址
会对 mcp-remote stderr 中常见 token 字段做脱敏
默认不在插件启动时自动联网刷新 manifest
如果 manifest 对应的 serverUrl 与当前配置不一致，会给出告警

更完整的说明见 SECURITY.md。

📝 已知限制

本项目透传的是官方 MCP，因此工具集合最终取决于官方 tools/list
CI 不做线上 OAuth 测试
连接复用保证仅限单个 OpenClaw 进程

📄 License

以仓库根目录实际的 LICENSE 文件为准。