任务管理服务器

一款基于MCP协议的AI辅助任务管理服务器,支持确定性操作和创造性任务处理。

  • by AsuraNale
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 AsuraNale/daily-assistant-mcp

使用说明

日常助理MCP服务器

通过MCP(模型上下文协议)实现人工智能驱动的日常任务管理

个人任务管理MCP服务器,可与Claude Code、OpenClaw和任何兼容MCP的AI代理配合使用。确定性操作(解析、排序、统计)在零令牌成本的代码中运行——人工智能只在需要创造力时介入。

特性

6工具

工具 说明
recommend_next 建议下一步要做的最重要的任务
get_today 读取今天的日常任务文件
inherit_tasks 继承昨天未完成的任务
check_overdue 检测过期的任务文件
generate_review 生成带有统计信息的日终审核
scan_split 标记过大(>80分钟)或缺少时间估计的任务

3资源

资源 内容
daily://today 今天的任务文件
daily://dashboard 仪表板概述
daily://history 7天完工统计

快速开始

先决条件

一个命令安装

# macOS / Linux
git clone https://github.com/AsuraNale/daily-assistant-mcp.git && cd daily-assistant-mcp && python3 src/setup.py --auto

# Windows
git clone https://github.com/AsuraNale/daily-assistant-mcp.git && cd daily-assistant-mcp && py src/setup.py --auto

就是这样。没有手册 pip install 需要。安装向导会自动执行以下操作:

  • 创建 .venv 并安装 fastmcp (隔离,无系统污染)
  • 创建数据目录(~/Desktop/日常小助手/Daily/ + Dashboard.md)
  • 生成 config.json
  • 检测已安装的AI编辑器,并为每个编辑器写入MCP配置

支持的编辑器 (自动检测):

编辑器 配置路径
克劳德代码 ~/.claude.json
光标 ~/.cursor/mcp.json
基罗 ~/.kiro/settings/mcp.json
风帆冲浪 ~/.codeium/windsurf/mcp_config.json

交互式安装(高级)

如果您更喜欢选择自定义数据目录:

python3 src/setup.py   # Windows: py src/setup.py

开始使用

打开你的AI编辑器,尝试:

  • “我接下来应该做什么?”→ calls recommend_next
  • “显示今天的任务”→ calls get_today
  • “继承昨天的任务”→ calls inherit_tasks
  • “有任何逾期任务吗?”→ calls check_overdue
  • “生成今天的评论”→ calls generate_review
  • “有需要拆分的任务吗?”→ calls scan_split

任务格式

任务用表情符号标记在Markdown中书写:

- [ ] Task description ⏱️45min 📅 2026-03-30 ⏫
标记 含义 必填
⏱️30min 时间估计(建议≤80min) 是
📅 YYYY-MM-DD 截止日期 是
⏫ 最高优先级 否
🔼 高优先级 否
🔽 低优先级 否

已完成的任务: - [x] Task description ...

网页用户界面

基于浏览器的仪表板,用于直观地管理任务:

# macOS / Linux
python3 src/web.py

# Windows
py -X utf8 src/web.py

打开 http://localhost:5000 自动。特征:

  • 任务清单 --选中/取消选中、添加、删除任务
  • 日期导航 --浏览过去和未来的每日文件
  • 仪表盘 --完成统计数据、逾期警报、7天趋势图、拆分提醒
  • 语言切换 --从右上角的下拉菜单中切换zh/en(保存到config.json)
  • 继承和审核 --一键式按钮,用于任务继承和每日审核生成

使用 --port 8080 更改默认端口。

文件结构

daily-assistant-mcp/
├── src/
│   ├── server.py      ← MCP Server entry point (stdio)
│   ├── web.py         ← Web UI entry point (localhost:5000)
│   ├── core.py        ← Core logic (shared by server.py & web.py)
│   ├── static/        ← Web UI frontend (HTML + CSS + JS)
│   ├── config.json    ← Generated by setup.py
│   └── setup.py       ← First-time setup wizard (supports --auto)
├── README.md
└── LICENSE

数据目录(用户可配置):

~/Desktop/日常小助手/
├── Daily/
│   ├── 2026-03-30.md
│   ├── 2026-03-29.md
│   └── ...
└── Dashboard.md

配置

config.json (自动生成 setup.py):

{
  "daily_dir": "/Users/you/Desktop/日常小助手/Daily",
  "dashboard_file": "/Users/you/Desktop/日常小助手/Dashboard.md",
  "language": "zh"
}

Language / 语言

集 "language" 在 config.json 在中文和英文之间切换所有工具输出:

值 语言 示例输出
"zh" 中文 (default) 🎉 今日任务清零!
"en" 英语 🎉 所有任务完成!

备注:MCP工具名称和描述仍为英文(MCP标准)。 唯有 输出文本 (推荐、评论、状态消息)受到影响。

您还可以传递自定义配置路径:

python3 src/server.py --config /path/to/config.json

设计理念

  • 零令牌确定性操作:解析、排序和统计在Python代码中运行——不消耗AI令牌
  • 仅在需要时使用AI:任务划分建议、创意建议、情境感知建议
  • 独立于平台:适用于Windows、macOS、Linux。不依赖Obsidian或任何特定编辑器
  • 简单数据格式:纯Markdown文件——使用任何文本编辑器进行编辑,版本控制友好

兼容性

平台 编辑器 状态
Windows 克劳德代码 ✅ 已测试
Windows 光标/基洛/风帆 ✅ 支持自动配置
macOS 克劳德代码 ✅ 兼容
macOS 光标/基洛/风帆 ✅ 支持自动配置
Linux 所有MCP编辑器 ✅ 兼容
ClawHub -- ✅ 已发布(daily-assistant)

许可证

麻省理工学院