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数据库目录 |
许可证
根据以下任一方式获得许可
- Apache许可证，版本2.0(特许通行证 或http://www.apache.org/licenses/LICENSE-2.0)
- MIT许可证(许可证-麻省理工学院 或http://opensource.org/licenses/MIT)
由您选择。
发展
uv run --extra dev pytest -v