龙猫矩阵 CLI

CLI 工具和 MCP 服务器，用于与龙猫矩阵（基于艾森豪威尔矩阵的待办事项应用）进行交互。

安装

全局安装：

npm install -g @ai666/todo-cli

或者直接通过 npx 使用（无需安装）：

npx @ai666/todo-cli --help

配置

此 CLI 支持多种配置方式，优先级从高到低如下：

1. 环境变量（最高优先级）
2. 配置文件
3. 默认值（最低优先级）

环境变量

| 变量 | 描述 | 默认值 | |------|------|--------| | TODO_API_URL | API 服务器地址 | http://localhost:3000 | | TODO_API_KEY | API 访问密钥 | (无) |

配置文件

配置文件位于 ~/.config/todo/config.json，包含如下结构：

{
  "apiUrl": "https://todoapi.ai666.cloud",
  "apiKey": "your-api-key-here"
}

配置命令

您也可以使用内建的配置命令管理设置：

# 设置配置
todo config set api-url https://todoapi.ai666.cloud
todo config set api-key your-api-key-here

# 获取配置
todo config get api-url
todo config get api-key

# 列出所有配置
todo config list

CLI 命令

添加任务

添加新任务到待办列表：

todo add "完成项目文档"

选项：

• -q, --quadrant <数字>: 艾森豪威尔矩阵象限 (1-4，默认为4)
  • 1: 紧急且重要
  • 2: 重要但不紧急
  • 3: 紧急但不重要
  • 4: 不紧急且不重要
• -d, --description <文本>: 任务描述
• --date <YYYY-MM-DD>: 计划日期 (默认为今天)
• --json: 以 JSON 格式输出

示例：

# 添加一个紧急重要的任务到今天的日程
todo add "修复生产环境错误" -q 1 -d "立即修复登录问题"

# 添加一个计划任务到特定日期
todo add "编写月度报告" -q 2 --date 2025-12-31 -d "需要包括所有关键指标"

完成任务

切换任务完成状态：

todo complete <任务_ID>

选项：

• --json: 以 JSON 格式输出

示例：

# 完成 ID 为 123 的任务
todo complete 123

# 返回 JSON 格式的响应
todo complete 123 --json

列出任务

列出当天的任务：

todo list

选项：

• --date <YYYY-MM-DD>: 指定日期的任务 (默认为今天)
• -q, --quadrant <数字>: 过滤指定象限 (1-4)
• --done: 只显示已完成的任务
• --undone: 只显示未完成的任务
• --json: 以 JSON 格式输出

示例：

# 列出今天的所有任务
todo list

# 只列出未完成的任务
todo list --undone

# 只列出已完成的任务
todo list --done

# 列出指定日期的任务
todo list --date 2025-12-31

# 列出特定象限的任务
todo list -q 2

# 组合过滤：未完成 + 指定象限
todo list --undone -q 1

# 返回 JSON 格式的任务列表
todo list --json

配置管理

管理 CLI 配置：

todo config set <键> <值>       # 设置配置值
todo config get <键>          # 获取配置值
todo config list              # 列出所有配置

JSON 输出

对于需要集成或脚本使用的场景，所有命令支持 --json 选项，输出机器可读的 JSON 格式。这些命令将标准输出改为 JSON 格式数据，方便解析处理。

示例 JSON 输出：

{
  "id": "task-id-string",
  "title": "任务标题",
  "quadrant": 2,
  "is_done": false,
  "description": "任务描述",
  "scheduled_date": "2025-12-31",
  "created_at": "2025-11-25T08:30:00Z"
}

MCP 服务器

模型上下文协议（Model Context Protocol，MCP）是一种开放标准，允许 AI 助手安全地调用外部工具。龙猫矩阵 CLI 包含一个 MCP 服务器，用于与您的待办事项应用进行集成。

启动 MCP 服务器

直接运行 MCP 服务器：

npx @ai666/todo-cli mcp

在 AI 客户端中配置 MCP

在 Cherry Studio 或 Claude Desktop 等支持 MCP 的客户端中，您可以配置 MCP 服务器来访问待办事项功能。服务器必须能够访问您的待办事项 API 且具有适当的认证凭据。

MCP 工具

龙猫矩阵 MCP 服务器提供三个核心工具：

add_task

添加新任务到待办列表。

输入模式：

{
  "title": {
    "type": "string",
    "minLength": 1,
    "maxLength": 100,
    "description": "任务标题"
  },
  "quadrant": {
    "type": "integer",
    "minimum": 1,
    "maximum": 4,
    "description": "艾森豪威尔矩阵象限 (1=紧急重要, 2=重要不急, 3=紧急不重要, 4=不急不重要)，默认值 4",
    "default": 4
  },
  "description": {
    "type": "string",
    "description": "任务描述，可选"
  },
  "scheduled_date": {
    "type": "string",
    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
    "description": "YYYY-MM-DD 格式的计划日期，可选"
  }
}

complete_task

切换任务完成状态。

输入模式：

{
  "task_id": {
    "type": "string",
    "minLength": 1,
    "description": "要切换的任务 ID"
  }
}

list_tasks

列出任务。

输入模式：

{
  "date": {
    "type": "string",
    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
    "description": "过滤特定日期，格式 YYYY-MM-DD，可选"
  },
  "quadrant": {
    "type": "integer", 
    "minimum": 1,
    "maximum": 4,
    "description": "按象限过滤 (1-4)，可选"
  },
  "is_done": {
    "type": "boolean",
    "description": "过滤完成状态 (true=已完成, false=未完成)，可选"
  }
}

配置示例

Cherry Studio 配置

{
  "mcpServers": {
    "todo": {
      "command": "npx",
      "args": ["-y", "@ai666/todo-cli", "mcp"],
      "env": {
        "TODO_API_URL": "https://todoapi.ai666.cloud",
        "TODO_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop 配置

{
  "mcpServers": {
    "todo": {
      "command": "npx",
      "args": ["-y", "@ai666/todo-cli", "mcp"],
      "env": {
        "TODO_API_URL": "https://todoapi.ai666.cloud",
        "TODO_API_KEY": "your-api-key"
      }
    }
  }
}