AI导哈

GitHub通知管理工具

一个通过gh CLI同步GitHub通知并在SQLite中跟踪处理状态的服务器，提供12种工具用于通知分类和工作项跟踪。

  • by butterflyskies
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 butterflyskies/gh-notify-mcp

使用说明

gh通知mcp

GitHub通知通过SQLite状态跟踪对MCP服务器进行分类。

通过以下方式同步GitHub通知 gh CLI，并在SQLite中本地跟踪分流状态（新/分流/已行动/已解除）。工作项预缓存跨会话上下文，因此 resolve_context("my-feature") 立即返回完整图片。展示12个MCP工具，用于通知分类和工作项跟踪。

工具

通知分类

工具 目的
sync_notifications 从GitHub获取通知，升级到SQLite
list_actionable 返回 new + triaged 项目（带有可选的仓库/原因/类型过滤器）
mark_triaged 将螺纹标记为已分流，并附上可选注释
mark_acted 标记为已执行；默认情况下在GitHub上读取标记
dismiss 断开一根线；默认情况下在GitHub上读取标记
get_stats 按状态、回购和原因汇总计数

工作项+上下文解析

工具 目的
create_work_item 创建命名工作项(id, title, description?)
update_work_item 更新字段； append_description 添加而不替换
list_work_items 列出带有链接计数的工作项，可选择按状态筛选
link_entity 链接GitHub URL/short-ref/工作项slug。自动检测实体类型。我暂时没有。
unlink_entity 删除实体和工作项之间的链接
resolve_context 完整上下文包：工作项slug、GitHub URL或短引用交叉引用通知。

设置

增添 ~/.claude.json 在...之下 mcpServers:

"gh-notify": {
  "type": "stdio",
  "command": "uv",
  "args": ["run", "--directory", "/path/to/gh-notify-mcp", "--extra", "mcp", "gh-notify-mcp"],
  "env": {
    "GH_CONFIG_DIR": "/path/to/gh-config"
  }
}

配置

环境变量 默认值 用途
GH_CONFIG_DIR ~/.config/gh GitHub CLI标识
GH_NOTIFY_GH_PATH gh gh二进制文件的路径
GH_NOTIFY_DB_DIR ~/.local/share/gh-notify SQLite数据库目录

许可证

根据以下任一方式获得许可

由您选择。

发展

uv run --extra dev pytest -v

相关 MCP