任务习惯追踪服务

Dayta MCP是一个本地运行的MCP服务器,提供任务管理、习惯追踪和反思记录功能,帮助用户保持组织和高效习惯。

  • by pruett
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 pruett/dayta-mcp

使用说明

Dayta MCP

用于管理日常任务、跟踪习惯和记录个人反思的模型上下文协议(MCP)服务器。该项目使用Next.js和MCP SDK构建,为人工智能助手提供结构化工具,帮助您在一天中保持有序并保持高效的习惯。

这是什么?

Dayta MCP是一个MCP服务器,旨在在您的机器上本地运行,并提供以下工具:

  • 任务管理:创建和跟踪每日待办事项列表
  • 习惯追踪:通过连续跟踪建立和监控每日/每周的习惯
  • 反思:保持每日日记条目和想法的时间戳

MCP+UI

除了MCP服务器,该项目还包括一个用Next.js构建的用户界面(UI)。UI允许您与MCP服务器交互,并直接从web浏览器管理您的任务、习惯和反思。

先决条件

  • 已安装Node.js 20+
  • npm、yarn、pnpm或bun包管理器

安装

  1. 克隆存储库

    git clone <your-repo-url>
    cd dayta-mcp
    
  2. 安装依赖项

    npm install
    # or
    yarn install
    # or
    pnpm install
    # or
    bun install
    
  3. 运行开发服务器

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
    # or
    bun dev
    

    服务器将在以下时间启动 http://localhost:3000

  4. 为生产而建 (可选)

    npm run build
    npm start
    

存储机制

所有数据都通过SQLite存储在 data/ 目录

可用的MCP工具

MCP服务器在 /mcp 路线:

任务管理

add_task

将新任务添加到日常任务列表中

参数:

  • description (字符串,必填):任务描述(1-500个字符)
  • date (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)

例子:

{
  "description": "Review MCP documentation",
  "date": "2025-10-31"
}

get_tasks

获取特定日期的所有任务

参数:

  • date (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)

退货: 指定日期的Markdown格式任务列表


习惯追踪

add_habit

养成新习惯或将现有习惯标记为已完成

参数:

  • name (字符串,必填):习惯名称(1-100个字符)
  • frequency (string,必填):“每日”或“每周”
  • completed (布尔值,可选):设置为true以标记今天的习惯

示例(培养新习惯):

{
  "name": "Morning Exercise",
  "frequency": "daily"
}

示例(标记习惯完成):

{
  "name": "Morning Exercise",
  "frequency": "daily",
  "completed": true
}

特征:

  • 自动跟踪完成条纹
  • 保留30天历史记录
  • 如果连续几天完成,则连续递增
  • 如果有间隙,将条纹重置为1

get_habits

通过跟踪数据获取所有习惯

参数: 无

退货: 带有条纹和历史记录的所有习惯的Markdown格式列表


反思

add_reflection

为特定日期添加带时间戳的反思或想法

参数:

  • text (字符串,必填):反射内容(1-5000个字符)
  • date (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)

例子:

{
  "text": "Today I learned about MCP servers and how they can integrate with AI assistants.",
  "date": "2025-10-31"
}

get_reflections

获取特定日期的所有反馈

参数:

  • date (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)

退货: 带时间戳的Markdown格式反射


MCP检验员测试

该项目包括 @modelcontextprotocol/inspector 用于在浏览器中测试MCP服务器的软件包。

设置检查器

  1. 安装检查器 (已包含在devDependencies中)

    npm install --save-dev @modelcontextprotocol/inspector
    
  2. 启动开发服务器

    npm run dev
    
  3. 运行MCP检查器

    npx @modelcontextprotocol/inspector
    
  4. 配置检查器

    • 在浏览器中打开检查器(通常在 http://localhost:5173)
    • 连接到您的MCP服务器 http://localhost:3000/mcp
    • 检查员将展示所有可用的工具
  5. 测试工具

    • 从列表中选择任何工具
    • 填写参数
    • 点击“运行”执行
    • 实时查看响应

测试示例

在Inspector中尝试这些:

  1. 添加任务:

    • 工具: add_task
    • 参数: {"description": "Test task from inspector"}
  2. 养成一个习惯:

    • 工具: add_habit
    • 参数: {"name": "Daily Reading", "frequency": "daily"}
  3. 标记习惯完成:

    • 工具: add_habit
    • 参数: {"name": "Daily Reading", "frequency": "daily", "completed": true}
  4. 添加反射:

    • 工具: add_reflection
    • 参数: {"text": "Testing the MCP Inspector is quite intuitive!"}

使用的技术

连接到克劳德桌面

要将此MCP服务器与Claude Desktop一起使用:

  1. 启动服务器 在生产模式下

    npm run build
    npm start
    
  2. 配置Claude桌面

    • 将服务器URL添加到Claude Desktop MCP配置中
    • MCP端点位于 http://localhost:3000/mcp
  3. 使用工具

    • 克劳德现在可以使用以下短语:
      • “将任务添加到我的列表中”
      • “我今天的任务是什么?”
      • “将我的晨练习惯标记为完整”
      • “添加关于…的反思”