md-todo-hub

把本地多个项目里散落在 Markdown 中的待办项，索引成一个共享的小型数据库（SQLite）， 通过 MCP 提供给大模型使用：跨项目查进度、按优先级排下一步、把完成状态写回原文档。

• Markdown 是唯一事实来源，索引只是查询层；所有写操作双写数据库与原文件。
• 支持表格行（| P1-1 | 标题 | 来源 | 影响 | ⏳ |）与清单（- [ ] 文本）两种格式。
• 索引库默认在 ~/.md-todo/index.db，可用 MD_TODO_HOME 改位置。
• 已发布 PyPI：md-todo-hub（当前 0.3.1）。

安装与启动（MCP）

# 直接运行 MCP server（stdio）
uvx --from md-todo-hub md-todo-hub

# 可选：启用语义检索 / 语义查重
uvx --from "md-todo-hub[semantic]" md-todo-hub

MCP 客户端配置示例：

{
  "mcpServers": {
    "md-todo-hub": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "md-todo-hub", "md-todo-hub"],
      "env": { "PYTHONUTF8": "1" }
    }
  }
}

命令行（同一套索引）

uvx --from md-todo-hub mdtodo register ~/project/foo   # 登记并索引一个项目
uvx --from md-todo-hub mdtodo overview                 # 跨项目进度总览
uvx --from md-todo-hub mdtodo next --limit 5           # 下一步该做什么
uvx --from md-todo-hub mdtodo search "登录"             # 全文检索
uvx --from md-todo-hub mdtodo status P1-1 done         # 标记完成（写回 Markdown）

主要 MCP 工具

环境变量

上架状态

zip 顶层目录即包名，解压直接看到 .codebuddy-plugin/plugin.json。 重新生成：bash scripts/build_release.sh [expert|connector|skill|all]。

开发

python -m pytest docs_mcp/tests/ -v

MIT License.