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包管理器
安装
- 克隆存储库```bash
git clone
cd dayta-mcp
1. **安装依赖项**```bash
npm install
# or
yarn install
# or
pnpm install
# or
bun install
- 运行开发服务器```bash
npm run dev
or
yarn dev
or
pnpm dev
or
bun dev
服务器将在以下时间启动 `http://localhost:3000`
1. **为生产而建** (可选)```bash
npm run build
npm start
存储机制
所有数据都通过SQLite存储在 data/ 目录
可用的MCP工具
MCP服务器在 /mcp 路线:
任务管理
add_task
将新任务添加到日常任务列表中
参数:
description(字符串,必填):任务描述(1-500个字符)date(字符串,可选):YYYY-MM-DD格式的日期(默认为今天)
例子:```json
{
"description": "Review MCP documentation",
"date": "2025-10-31"
}
#### `get_tasks`
获取特定日期的所有任务
**参数:**
- `date` (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)
**退货:** 指定日期的Markdown格式任务列表
______________________________________________________________________
### 习惯追踪
#### `add_habit`
养成新习惯或将现有习惯标记为已完成
**参数:**
- `name` (字符串,必填):习惯名称(1-100个字符)
- `frequency` (string,必填):“每日”或“每周”
- `completed` (布尔值,可选):设置为true以标记今天的习惯
**示例(培养新习惯):**```json
{
"name": "Morning Exercise",
"frequency": "daily"
}
示例(标记习惯完成):```json
{
"name": "Morning Exercise",
"frequency": "daily",
"completed": true
}
**特征:**
- 自动跟踪完成条纹
- 保留30天历史记录
- 如果连续几天完成,则连续递增
- 如果有间隙,将条纹重置为1
#### `get_habits`
通过跟踪数据获取所有习惯
**参数:** 无
**退货:** 带有条纹和历史记录的所有习惯的Markdown格式列表
______________________________________________________________________
### 反思
#### `add_reflection`
为特定日期添加带时间戳的反思或想法
**参数:**
- `text` (字符串,必填):反射内容(1-5000个字符)
- `date` (字符串,可选):YYYY-MM-DD格式的日期(默认为今天)
**例子:**```json
{
"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服务器的软件包。
设置检查器
- 安装检查器 (已包含在devDependencies中)```bash
npm install --save-dev @modelcontextprotocol/inspector
1. **启动开发服务器**```bash
npm run dev
- 运行MCP检查器```bash
npx @modelcontextprotocol/inspector
1. **配置检查器**
- 在浏览器中打开检查器(通常在 `http://localhost:5173`)
- 连接到您的MCP服务器 `http://localhost:3000/mcp`
- 检查员将展示所有可用的工具
1. **测试工具**
- 从列表中选择任何工具
- 填写参数
- 点击“运行”执行
- 实时查看响应
### 测试示例
在Inspector中尝试这些:
1. **添加任务:**
- 工具: `add_task`
- 参数: `{"description": "Test task from inspector"}`
1. **养成一个习惯:**
- 工具: `add_habit`
- 参数: `{"name": "Daily Reading", "frequency": "daily"}`
1. **标记习惯完成:**
- 工具: `add_habit`
- 参数: `{"name": "Daily Reading", "frequency": "daily", "completed": true}`
1. **添加反射:**
- 工具: `add_reflection`
- 参数: `{"text": "Testing the MCP Inspector is quite intuitive!"}`
## 使用的技术
- **Next.js 16**:带有App Router的React框架
- **模型上下文协议SDK**:Anthropic官方MCP SDK
- **mcp处理器**:简化了MCP服务器的创建
- **萨德**:TypeScript第一模式验证
- **TypeScript**:类型安全的JavaScript
- **生物群系**:快速格式化器和linter
- **Tailwind CSS**:实用程序优先的CSS框架
## 连接到克劳德桌面
要将此MCP服务器与Claude Desktop一起使用:
1. **启动服务器** 在生产模式下```bash
npm run build
npm start
- 配置Claude桌面
- 将服务器URL添加到Claude Desktop MCP配置中
- MCP端点位于
http://localhost:3000/mcp
- 使用工具
- 克劳德现在可以使用以下短语:
- “将任务添加到我的列表中”
- “我今天的任务是什么?”
- “将我的晨练习惯标记为完整”
- “添加关于…的反思”
