挠痒器mcp
为Claude Code代理和任何MCP客户提供持续的挠痒/提醒。Tickers存储在本地JSON文件中——它们在会话重启、重新连接和机器重启后仍然存在。
它解决的核心问题是: 克劳德的特工们在开会。当会话结束时,内存中的状态将消失。如果代理人想在3天内跟进某件事,就没有地方表达这个意图。麦哲伦就是那个地方。
插件安装(Claude代码)
两个步骤——添加市场,然后安装插件:
claude plugin marketplace add daveremy/tickler-mcp
claude plugin install tickler-mcp@tickler-mcp-plugins --scope user安装后启动新的Claude Code会话。将提供6个挠痒器MCP工具,并捆绑 /tickler 技能会自动发挥作用。
手动安装
添加到您的 .mcp.json (或 ~/Library/Application Support/Claude/claude_desktop_config.json 克劳德桌面版):
{
"mcpServers": {
"tickler-mcp": {
"command": "npx",
"args": ["-y", "-p", "tickler-mcp", "tickler-mcp"]
}
}
}或全局安装:
npm install -g tickler-mcp工具参考
| 工具 | 说明 |
|---|---|
tickler_create | 创建一个新的挠痒器 |
tickler_check | 返回过期的待处理挠痒器(用于cron/晨检) |
tickler_list | 列出所有挠痒器,可选择按状态或标签过滤 |
tickler_complete | 标记挠痒器完成 |
tickler_delete | 永久去除发痒物 |
tickler_snooze | 将到期日提前一段时间:“1d”、“3h”、“1w”、“30m” |
命令行界面
全局安装或通过npx安装后:
# Check what's due
tickler check
# List all
tickler list
tickler list --status pending
tickler list --tag projects
# Create
tickler create "Follow up on invoice" --due "2026-04-01T09:00:00-07:00" --body "Invoice #1042 sent March 26"
tickler create "Weekly review" --due "2026-03-30T08:00:00-07:00" --tags "recurring,review"
# Complete
tickler complete
# Delete
tickler delete
# Snooze (duration string: 30m, 3h, 1d, 1w)
tickler snooze 3d
tickler snooze 4h技能
该插件捆绑了a /tickler 技能。安装插件后,直接使用:
/tickler check
/tickler create "Follow up on invoice in 3 days"该技能能够协调工具调用,并以对话的方式呈现结果。
存储
违约: ~/.tickler/ticklers.json
用环境变量覆盖:
{
"mcpServers": {
"tickler-mcp": {
"command": "npx",
"args": ["-y", "-p", "tickler-mcp", "tickler-mcp"],
"env": {
"TICKLER_PATH": "/path/to/your/ticklers.json"
}
}
}
}集成模式
早间评论投票
在日常复习中,请致电 tickler_check 第一。如果有任何东西被退回,请在继续进行其余的审查之前向用户展示。
代理cron作业
按计划运行的代理(通过 CronCreate)可以打电话 tickler_check 在启动时。这是主要的用例——代理设置一个挠痒器,会话结束,未来的会话会自动拾取它。
示例提示:
At the start of each session, call tickler_check. If any past-due ticklers are found,
surface them to the user and ask what to do.在会话内创建跟进
User: "Remind me to follow up on this in a week"
Agent: [calls tickler_create with due = now + 7 days]打盹而不是完成
如果用户还没有准备好对挠痒者采取行动,但不想让它弄乱列表:
Agent: [calls tickler_snooze with id: "...", duration: "3d"]未来:通过MCP采样推送通知
MCP规范包括一个采样功能,允许服务器主动通知客户端——本质上是将通知从MCP服务器推送到代理。当客户对采样的支持成熟时,ticker mcp可以扩展到推送逾期提醒,而不需要轮询步骤。
目前,投票通过 tickler_check 在cron中,作业和晨检是可靠的模式。
发展
git clone https://github.com/daveremy/tickler-mcp.git
cd tickler-mcp
npm install
npm run build
# Test CLI
node dist/cli.js create "Test" --due "2026-04-01T00:00:00Z" --body "testing"
node dist/cli.js list
# Test MCP (stdio)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' | node dist/mcp.js释放
npm run release patch # 0.1.0 -> 0.1.1
npm run release minor # 0.1.1 -> 0.2.0
npm run release major # 0.2.0 -> 1.0.0看 CLAUDE.md 获取完整的开发指南。
许可证
麻省理工学院
