我的开发人员笔记
VS Code侧边栏扩展,用于管理工作区范围的TODO和草稿笔记,并集成了用于AI代理的MCP服务器。
特性
- 待办事项 --添加、编辑、勾选和拖动重新排序任务。组织指定的小组。
- 备注 --Markdown剪贴簿笔记。使用markdown编写,请查看渲染输出。双击进行编辑。
- 群组 --创建命名组来组织TODO。拖动可对组进行重新排序。
- 档案 --已完成的TODO将存档7天,然后自动清理。
- 可折叠部分 --折叠TODO、Notes和单个组。
- MCP服务器 --AI代理(例如Claude Code)可以读取和管理您的TODO和笔记。
安装
VS代码扩展
- 克隆仓库并安装依赖项:
git clone https://github.com/reefbarman/mydevnotes.git
cd mydevnotes
npm install- 构建扩展:
npm run compile
npm run bundle:mcp
npm run bundle:webview- 在VS代码中本地安装——或者:
- 在VS Code中打开仓库,按 F5 启动扩展开发主机,或
- 打包并安装 .vsix:
npx @vscode/vsce package
code --install-extension mydevnotes-*.vsix- “My Dev Notes”图标将出现在活动栏侧栏中。
MCP服务器(用于AI代理)
该扩展可以使用Claude Code自动注册其MCP服务器。首次激活时,系统会提示您启用此功能。如果您选择“启用”,它将写入以下内容 ~/.claude.json:
{
"mcpServers": {
"mydevnotes": {
"command": "node",
"args": ["/path/to/extension/out/mcp-server.js"]
}
}
}要手动注册,请将上述内容添加到您的 ~/.claude.json (更新路径以指向已安装的扩展 out/mcp-server.js).
MCP服务器使用 process.cwd() 确定要读/写哪个工作区的数据,这样当Claude Code将工作目录设置为项目根目录时,它就会自动工作。
您可以通过以下方式控制自动注册 mydevnotes.mcpAutoRegister 设置(请参阅下面的配置)。
MCP工具
TODO工具
| 工具 | 说明 |
|---|---|
list_todos | 列出活动TODO(可选组筛选器) |
list_completed_todos | 列出已完成的TODO |
add_todo | 添加一个或多个TODO |
complete_todo | 将TODO标记为已完成 |
uncomplete_todo | 恢复已完成的TODO |
delete_todo | 永久删除TODO |
edit_todo | 编辑待办事项文本 |
move_todo | 在组之间移动TODO |
list_groups | 列出所有组 |
add_group | 创建新组 |
rename_group | 重命名组 |
delete_group | 删除组 |
笔记工具
| 工具 | 说明 |
|---|---|
list_notes | 列出所有笔记并预览 |
add_note | 添加注释(支持markdown) |
edit_note | 编辑笔记内容 |
delete_note | 删除注释 |
配置
| 设置 | 说明 | 默认值 |
|---|---|---|
mydevnotes.mcpAutoRegister | 自动注册MCP服务器(enabled, disabled, ask) | ask |
数据存储
状态存储在 ~/.mydevnotes/data.json,按工作区路径键控。这可以保持项目目录的干净——没有每个项目的配置文件或 .gitignore 需要的条目。
