慢跑MCP
轻量级MCP服务器,用于跨会话维护编码上下文
在切换分支、休息或在功能之间切换上下文时,永远不要失去你的精神状态。Jot允许您自然地记录您正在做的事情,并在稍后通过与Claude Code的对话进行检索。
特性
- 零摩擦测井 -自然对话,无需记忆命令
- 智能上下文检测 -从git repo/branch自动检测
- 全文搜索 -按关键字、标签、日期或上下文查找笔记
- 自动过期 -默认情况下,Jots在2周后过期(可配置)
- SQLite存储 -快速、本地、可靠
快速开始
选项1:插件安装(推荐)
在Claude Code中,添加市场并安装插件:
/plugin marketplace add veelenga/jot-mcp
/plugin install jot-mcp@jot-mcp然后重新启动Claude Code以激活插件。
选项2:NPM安装
npm install -g jot-mcp然后配置克劳德代码:
claude mcp add --scope user jot jot-mcp用法
自然对话
与Claude Code自然对话:
"jot: Implemented Redis caching"
"Remember this: database migration requires manual step"
"This is important: API keys in 1Password vault""Show jots" # Current context
"Show all jots" # All contexts
"What was I working on?" # Recent work recap
"Search jots about auth" # Full-text search"Update jot 5 with message 'Updated implementation'"
"Delete jot 3"
"Make jot 7 permanent"MCP工具
Jot MCP仅提供3种工具,以实现最高的代币效率:
| 工具 | 操作 | 说明 |
|---|---|---|
jot | 创建、更新、删除 | 创建、更新或删除jots(自动检测git中的上下文) |
list_jots | - | 列出或搜索带有可选过滤器(查询、标签、日期)的笔记 |
context | list,delete | 列出所有上下文或删除特定上下文 |
注: 在列表/搜索操作期间,过期的笔记会在后台自动清理。
存储
点存储在SQLite本地:
- macOS/Linux:
~/.config/jot-mcp/jots.sqlite - 窗户:
%APPDATA%\jot-mcp\jots.sqlite
备份: 只需复制此文件即可备份您的笔记。
故障排除
服务器未连接:
jot-mcp --version # Check installation
npm install -g jot-mcp # Reinstall if needed
claude mcp list # Verify configuration上下文自动检测不起作用:
- 确保你在git存储库中(
git status) - 或者手动指定上下文:
"jot to my-context: message"
发展
npm install # Install dependencies
npm run build # Build the project
npm test # Run tests (76 tests covering all layers)
npm run watch # Watch mode for development链接
-
