loading…
Search for a command to run...
loading…
An MCP server for managing alarms and todo lists with support for natural language time parsing and persistent data storage. It enables AI assistants to set rem
An MCP server for managing alarms and todo lists with support for natural language time parsing and persistent data storage. It enables AI assistants to set reminders, track tasks, and provide active notifications for upcoming events.
为小智AI提供闹钟和待办事项管理功能的MCP服务。
🎉 V2 主动通知版本已发布！
详细测试指南请查看: V2_TEST_GUIDE.md
cd mcp-reminder
项目使用UV管理依赖：
uv sync
项目已包含 mcp_pipe.py 和启动脚本，开箱即用。默认启动V2版本（支持主动通知）。
Linux/Mac:
chmod +x start.sh
./start.sh
Windows PowerShell (推荐):
.\start.ps1
如果提示无法运行脚本，先执行：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
Windows CMD:
start.bat
⚠️ Windows用户注意:
.\start.ps1这将自动连接到配置好的小智MCP接入点并启动服务。
如需自定义配置，可以手动设置环境变量：
Linux/Mac:
export MCP_ENDPOINT="wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"
uv run python mcp_pipe.py run_server.py
Windows (PowerShell):
$env:MCP_ENDPOINT = "wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"
uv run python mcp_pipe.py run_server.py
Windows (CMD):
set MCP_ENDPOINT=wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN
uv run python mcp_pipe.py run_server.py
复制配置文件模板：
cp mcp_config.json.example mcp_config.json
编辑 mcp_config.json 自定义配置，然后运行：
export MCP_ENDPOINT="wss://api.xiaozhi.me/mcp/?token=YOUR_TOKEN"
uv run python mcp_pipe.py
用于本地测试MCP工具功能（不连接小智）：
uv run python -m mcp_reminder.server
然后可以使用MCP Inspector或其他MCP客户端连接测试。
设置一个闹钟。
参数：
time (必填): 闹钟时间，支持自然语言description (可选): 闹钟描述示例：
语音："小智，帮我设置一个下午2点30分的闹钟"
语音："小智，明天上午9点提醒我开会"
获取所有已到期且未关闭的闹钟（小智会定期自动调用）。
关闭指定的闹钟。
参数：
alarm_id (必填): 闹钟ID创建一个新的待办事项。
参数：
title (必填): 待办事项标题remind_time (可选): 提醒时间，支持自然语言description (可选): 待办事项描述示例：
语音："小智，提醒我明天下午3点完成项目文档"
语音："小智，添加待办：给客户发送报价单"
获取所有到期且未完成的待办事项（小智会定期自动调用）。
标记待办事项为已完成，支持通过标题模糊匹配。
参数：
title (必填): 待办事项标题或关键词示例：
语音："小智，我已经完成项目文档了"
语音："小智，报价单发完了"
查看所有待办事项。
参数：
status (可选): 筛选状态"pending": 未完成（默认）"completed": 已完成"all": 全部示例：
语音："小智，我有哪些待办事项"
语音："小智，列出所有已完成的任务"
一次性检查所有到期的闹钟和待办事项。
重要：提醒机制说明
参数：
返回：
示例：
语音："小智，检查一下有没有到期的提醒"
语音："小智，看看有什么要提醒我的"
详细说明请查看： REMINDER_MECHANISM.md
数据以JSON格式存储在 data/ 目录下：
data/alarms.json - 闹钟数据data/todos.json - 待办事项数据mcp-reminder/
├── src/mcp_reminder/
│ ├── __init__.py
│ ├── models.py # 数据模型
│ ├── storage.py # JSON持久化
│ └── server.py # MCP服务入口
├── data/ # 数据存储目录
├── pyproject.toml # UV项目配置
└── README.md
添加测试数据：
# 在Python REPL中测试
uv run python
from mcp_reminder.storage import JSONStorage
from mcp_reminder.models import Alarm, Todo, parse_time
storage = JSONStorage()
# 添加闹钟
alarm = Alarm(time=parse_time("2分钟后"), description="测试闹钟")
storage.add_alarm(alarm)
# 添加待办
todo = Todo(title="测试待办", remind_time=parse_time("1分钟后"))
storage.add_todo(todo)
未来可以考虑添加：
MIT License
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"mcp-reminder": {
"command": "npx",
"args": []
}
}
}