GitHub 通知 MCP 服务器
一个 MCP(模型上下文协议)服务器,提供用于管理 GitHub 通知的工具。该服务器允许像 Claude 这样的 AI 助手通过自然语言命令帮助您管理 GitHub 通知。
特征
列出并过滤您的 GitHub 通知
将通知标记为已读
查看通知线程详细信息
订阅或取消订阅通知线程
将话题标记为已完成
管理特定于存储库的通知
控制存储库通知设置(所有活动、默认或静音)
Related MCP server: GitHub MCP Server
先决条件
Node.js 18 或更高版本
带有
notifications或repo范围的 GitHub 个人访问令牌(经典)
安装
克隆此存储库
git clone https://github.com/yourusername/github-notifications-mcp-server.git cd github-notifications-mcp-server安装依赖项
npm install构建项目
npm run build使用你的 GitHub 令牌创建一个
.env文件GITHUB_TOKEN=your_github_personal_access_token_here
用法
直接运行服务器
与 Claude Desktop 一起使用
将服务器添加到您的claude_desktop_config.json文件:
可用工具
工具名称 | 描述 |
| 列出经过身份验证的用户的所有 GitHub 通知 |
| 将所有通知标记为已读 |
| 获取有关通知线程的信息 |
| 将特定主题标记为已读 |
| 将话题标记为已完成 |
| 获取主题的订阅状态 |
| 订阅主题 |
| 取消订阅主题 |
| 列出特定存储库的通知 |
| 将存储库的通知标记为已读 |
| 管理存储库订阅:all_activity、默认(参与和@mentions)或忽略(静音) |
示例提示
以下是服务器连接后您可以在 Claude Desktop 中使用的一些示例提示:
“你能查看我的 GitHub 通知吗?”
“显示过去 24 小时内未读的通知。”
“将我的所有通知标记为已读。”
“您能告诉我有关通知线程 12345 的信息吗?”
“取消我订阅主题 12345。”
“我对 octocat/Hello-World 存储库有哪些通知?”
“将来自 octocat/Hello-World 存储库的所有通知标记为已读。”
“监视 octocat/Hello-World 存储库上的所有活动。”
“将 octocat/Hello-World 存储库设置为默认设置(参与和 @mentions)。”
“检查 octocat/Hello-World 存储库的通知设置。”
“将来自 octocat/Hello-World 存储库的所有通知静音。”
发展
URL 处理
此服务器会自动将 GitHub API URL 转换为其对应的 Web UI URL。例如:
API网址:
https://api.github.com/repos/nodejs/node/pulls/57557转换为:
https://github.com/nodejs/node/pull/57557
转换处理:
域名从
api.github.com/repos转换为github.com拉取请求的路径修正(将
pulls更改为pull)保留额外的路径段
项目结构
建筑
测试
运行自动化测试:
手动测试 URL 转换:
执照
麻省理工学院