Daily Assistant MCP

日常助理MCP服务器

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

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

特性

6工具

3资源

快速开始

先决条件

• Python 3.10+
• 什么之中的一个： 克劳德代码 / 光标 / 基罗 / 帆板运动 或任何与MCP兼容的AI代理

一个命令安装

# 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配置

支持的编辑器 （自动检测）：

交互式安装（高级）

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

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 ⏫

已完成的任务： - [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 在中文和英文之间切换所有工具输出：

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

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

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

设计理念

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

兼容性

许可证

麻省理工学院