关于 Agentic Task System (ATS)
Agentic Task System(ATS)是一个 MCP 服务,通过可替换的存储适配器向客户端提供任务应用的数据与操作。其工具结合检索、任务上下文、层级管理、访问检查和状态事件跟踪。
主要功能
- 01结合 RRF 的混合任务检索
- 02读取、创建和更新任务
- 03任务意图、层级与生命周期控制
- 04范围化访问检查和审计记录
- 05类型化任务关联与图遍历
- 06持久化任务状态事件轮询
适用场景
- 01通过 ATS 适配器搜索任务
- 02为 Agent 提供明确的任务上下文
- 03在执行操作前检查范围权限
- 04为下游使用方跟踪任务变化
MCP 相关
它向 MCP 客户端提供 ATS 任务检索、管理、上下文、安全检查和事件工具。存储由适配器选择,文档中默认使用 TickTick。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @reneza/ats-mcpATS_ADAPTERnpm package name of the storage adapter to load, e.g. @reneza/ats-adapter-ticktick (TickTick), @reneza/ats-adapter-notion, @reneza/ats-adapter-github, @reneza/ats-adapter-beads本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@reneza/ats-mcp
适用于 Agentic Task System 的模型上下文协议服务。
它可将你已经在使用的任务应用通过一小组工具提供给任何 MCP 客户端(Claude Desktop、Cursor 等),并由 ATS 的混合检索 + RRF 提供支持。它与存储无关:只要适配器符合 ATS 约 6 个方法的契约,就能运行。通用适配器可免费获得关键词 + 原生检索 + RRF 融合;由嵌入器支持的适配器(例如 TickTick)则可使用完整的稠密 / 稀疏混合检索。
工具
| 工具 | 功能 |
|---|---|
find | 获取可用的适配器信号,并通过 RRF 融合 Core 关键词检索。支持嵌入的适配器还会加入稠密 + 稀疏混合检索。传入 explain: true 可查看每个结果的详细说明。 |
get_task | 按项目 ID + 任务 ID 获取单个条目(完整正文)。 |
list_projects | 列出项目 / 文件夹。 |
create_task | 创建条目——双向总线中从 Agent 到人的写入端。 |
update_task | 部分更新现有条目。 |
similar | 查找语义相似的条目(由嵌入器支持的适配器)。 |
url_for | 生成可直接粘贴的深层链接,跳转回原生应用中的条目。 |
set_task_intent | 存储结果、完成条件、权限、约束和审批要求。 |
promote_exploration | 创建已承诺执行的条目,并将来源链接为证据,不复制其正文。 |
get_task_hierarchy / set_task_hierarchy | 读取或指定探索 / 目标 / 项目 / 任务角色,以及一个明确的父项。 |
evaluate_task_hierarchy | 检查父项支持、角色顺序、循环、生命周期有效性和当前明确冲突。 |
set_task_lifecycle | 设置 active/archived/superseded 状态和有效期。 |
get_task_security / set_task_security | 读取或定义任务内容的信任级别、操作 / 资源范围、拒绝规则和审批边界。 |
check_task_access | 要求提供理由,评估一项有范围的请求,并追加一条允许 / 拒绝审计记录。 |
add_task_link | 在两个任务之间添加带类型的关系。 |
remove_task_link | 移除一条指定的带类型关系。 |
task_graph | 遍历传入和传出的带类型关系。 |
context_for_task | 先返回有效的明确上下文,再返回检索发现,并附带来源信息。 |
record_action / list_actions | 写入并检查只追加的 Agent 操作日志。 |
snapshot_task_events / poll_task_events | 建立并轮询确定性的任务状态事件,在推进检查点之前先持久暂存。仅观察,不执行 Agent 操作。 |
list_pending_task_events / acknowledge_task_events | 恢复未确认的事件信封,并显式移除已成功处理的 ID。 |
安全工具是协作 MCP 客户端的决策点。它们不会对 ATS 以外的工具进行沙箱隔离。 事件工具只会发出状态变更。本地暂存区存储的是引用和哈希,而不是任务正文。使用方仍需负责意图、生命周期、访问检查,以及成功处理后的确认。
安装和运行
npm install -g @reneza/ats-mcp @reneza/ats-adapter-ticktick
ats-mcp # stdio server
当前活动的适配器按与 CLI 完全相同的方式解析:
ATS_ADAPTER环境变量,否则~/.config/ats/adapter(一行内容,填写适配器包名称),否则@reneza/ats-adapter-ticktick。
接入 Claude Desktop
{
"mcpServers": {
"ats": {
"command": "ats-mcp",
"env": { "ATS_ADAPTER": "@reneza/ats-adapter-ticktick" }
}
}
}
使用其他存储
将其指向任意 ATS 适配器——markdown 文件夹、Obsidian、Notion,或你自己的存储:
ATS_ADAPTER=@you/ats-adapter-obsidian ats-mcp
请参阅适配器契约——包含 6 个存储方法,以及身份验证生命周期钩子。
- 来源: https://github.com/renezander030/agentic-task-system
- 许可证: MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。