Toki MCP 服务器使用指南

项目简介

Toki 是一个智能的 CLI 待办事项管理器，具有 Git 仓库上下文感知功能。它通过 MCP 协议向 AI 代理提供强大的任务管理工具、数据资源和预设工作流程，让AI能够高效地协助用户管理项目和任务。

主要功能

• 项目管理：创建、列出和删除项目容器
• 待办事项管理：创建、更新、删除和标记待办事项
• 丰富的元数据：支持优先级、标签、备注和截止日期
• Git 感知：自动检测当前 Git 仓库并关联相应项目
• 任务筛选：按项目、状态、优先级和标签过滤
• 同步功能：支持云端数据同步和跨设备访问
• 智能标签系统：自动分类和组织任务
• 多代理协作：通过标签和优先级实现任务分配和状态同步

安装步骤

# 使用 Go 安装
go install github.com/harper/toki/cmd/toki@latest

服务器配置

在 Claude Desktop 配置文件 ('~/Library/Application Support/Claude/claude_desktop_config.json' on macOS) 中添加以下配置：

{
  "mcpServers": {
    "toki": {
      "command": "toki",
      "args": ["serve"]
  }
}

基本使用方法

1. 配置完成后重启 Claude Desktop
2. AI代理可以通过以下方式使用Toki：

工具操作（11个）：

• 创建待办事项：'add_todo'
• 列出待办事项：'list_todos'

2. 访问数据资源：
   • 所有待办事项：'toki://todos'
   • 未完成事项：'toki://todos/pending"
   • 逾期事项：'toki://todos/overdue"
   • 高优先级事项：'toki://todos/high-priority"
   • 项目列表：'toki://projects'
   • 统计信息：'toki://stats'

预设工作流程：

• 'plan-project'：将新项目分解为可执行任务
• 'daily-review'：每日站会和规划工作流程
• 'sprint-planning'：将工作组织为专注的迭代周期