AI导哈

AI代理任务规划系统

Telos-MCP是一款为AI代理设计的任务规划与追踪工具，提供基于项目的组织架构和兼容Obsidian的Markdown存储功能。

  • by Skye-flyhigh
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Skye-flyhigh/telos-mcp

使用说明

telos-mcp

AI代理的任务规划和跟踪。具有基于项目的组织和与Obsidian兼容的降价存储的MCP服务器。

它做什么

为任何与MCP兼容的AI代理提供持久任务管理：

  • 创建、更新、列出、删除 具有完整状态跟踪的任务
  • 项目 --使用元数据（技术栈、仓库URL、源代码）按项目组织任务
  • 依赖项 --blockedBy/阻止任务之间的关系
  • 批量操作 --一次创建多个任务
  • 任务树 --具有父子关系的任务的层次视图
  • Markdown文件 --每个任务都是一个包含README.md和YAML frontmatter的文件夹
  • 黑曜石融合 --与黑曜石保管库、Dataview和wiki链接完全兼容
  • 零本机插件 --纯JavaScript，适用于任何Node版本，无需重新构建
  • 多代理 --所有者跟踪，以便您知道谁在做什么

快速开始

npx telos-mcp

稳定安装

npm install -g telos-mcp

或来源：

git clone https://github.com/skye-flyhigh/telos-mcp.git
cd telos-mcp && npm install && npm run build

然后向您的客户指出 "command": "node", "args": ["/path/to/telos-mcp/dist/index.js"].

配置

变量 默认值 描述
TELOS_DIR ~/.telos 存储任务文件的目录

集 TELOS_DIR 要覆盖默认存储位置，请执行以下操作：

TELOS_DIR=/custom/path npx telos-mcp

或者在MCP配置中：

{
  "mcpServers": {
    "telos": {
      "command": "npx",
      "args": ["telos-mcp"],
      "env": { "TELOS_DIR": "/custom/path" }
    }
  }
}

客户端设置

克劳德代码

增添 .claude.json:

{
  "mcpServers": {
    "telos": {
      "type": "stdio",
      "command": "npx",
      "args": ["telos-mcp"],
      "env": {}
    }
  }
}

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "telos": {
      "command": "npx",
      "args": ["telos-mcp"]
    }
  }
}

工具

任务管理

工具 说明
task_create 使用主题、描述、标签、依赖关系、project_id创建新任务
task_update 更新现有任务的状态、依赖关系、项目或详细信息
task_get 按ID获取任务的完整详细信息
task_list 列出所有任务（摘要视图），并带有可选筛选器
task_delete 按ID删除任务（删除文件夹）
task_move 将任务移动到其他项目（或全局任务）
task_create_bulk 一次创建多个任务
task_tree 获取包含所有子体的任务层次结构树

项目管理

工具 说明
telos_project_create 创建新项目以组织任务
telos_project_get 按键获取完整的项目信息
telos_project_list 列出所有具有可选筛选的项目
telos_project_update 更新项目元数据
telos_project_archive 存档项目（移动到存档/年/）

状态工作流

pending → planning → in_progress → reviewing → completed
   ↓          ↓           ↓            ↓
blocked   archived    deleted

使用 status: "deleted" 在 task_update 删除任务（与 task_delete). 使用 status: "archived" 在不进行主动跟踪的情况下保留任务历史记录。

依赖项

任务可以相互阻塞：

  • blockedBy: [1, 3] --在任务1和3完成之前，此任务无法启动
  • 当任务完成时，它会自动从依赖项中删除 blockedBy
  • 删除任务时，所有依赖关系引用都会被清理

存储格式

目录结构

~/.telos/
├── tasks/                          # Global tasks (no project)
│   └── {id}-{slug}/
│       └── README.md
├── projects/
│   └── {key}/                      # e.g., "mnemo", "black-cat"
│       ├── project.md            # Project metadata
│       └── tasks/
│           └── {id}-{slug}/
│               └── README.md
└── archive/
    └── {year}/
        └── {key}/                  # Archived projects preserved
            ├── project.md
            └── tasks/

任务格式

每个任务都是一个包含YAML frontmatter的README.md文件夹：

---
id: 1
project_id: mnemo
subject: Fix authentication bug
status: in_progress
created: 2026-03-06T10:00:00.000Z
updated: 2026-03-06T12:30:00.000Z
owner: claude
activeForm: Fixing authentication bug
blockedBy: [3]
blocks: [5, 7]
tags: [backend, auth]
depth: 0
sources:
  - https://docs.example.com
  - https://github.com/org/repo/issues/42
---

Detailed description with full markdown support.

项目格式

每个项目都是一个 project.md 带有YAML frontmatter和markdown body的文件：

---
key: mnemo
display_name: Mnemo MCP
tech_stack: [typescript, mcp]
repo_url: "https://github.com/skye-flyhigh/mnemo"
status: active
created: "2026-03-06T10:00:00.000Z"
updated: "2026-03-06T12:00:00.000Z"
archived_at: null
archived_reason: null
sources:
  - https://modelcontextprotocol.io
---

Memory management for AI agents. Description goes here as markdown body.

黑曜石融合

Telos专为黑曜石兼容性而设计：

  • Markdown文件 --每个任务都是README.md，每个项目都是project.md
  • YAML 前注 --标准YAML格式的元数据
  • Wiki链接 — [[project-key]] 任务和项目之间的联系
  • 数据视图查询 --任务和项目列表的动态表
  • 图形视图 --视觉任务↔ 项目关系

打开 ~/.telos 作为黑曜石拱顶，用于完全可视化。

许可证

麻省理工学院

相关 MCP