GitHub 通知 MCP 服务器

一个 MCP (模型上下文协议) 服务器，提供用于管理 GitHub 通知的工具。此服务器允许像 Claude 这样的 AI 助手通过自然语言命令帮助您管理 GitHub 通知。

功能

• 列出和过滤您的 GitHub 通知
• 将通知标记为已读
• 查看通知线程详情
• 订阅或取消订阅通知线程
• 将线程标记为完成
• 管理特定于仓库的通知
• 控制仓库通知设置（所有活动、默认或静音）

前提条件

• Node.js 18 或更高版本
• 具有 notifications 或 repo 作用域的 GitHub 个人访问令牌（经典）

安装

1. 克隆此仓库

   git clone https://github.com/yourusername/github-notifications-mcp-server.git
   cd github-notifications-mcp-server
   

2. 安装依赖项

   npm install
   

3. 构建项目

   npm run build
   

4. 创建一个包含您的 GitHub 令牌的 .env 文件

   GITHUB_TOKEN=your_github_personal_access_token_here
   

用法

直接运行服务器

npm start

与 Claude Desktop 一起使用

将服务器添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "github-notifications": {
      "command": "node",
      "args": ["/absolute/path/to/github-notifications-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token_here"
      }
    }
  }
}

可用工具

工具名称	描述
list-notifications	列出已验证用户的所有 GitHub 通知
mark-notifications-read	将所有通知标记为已读
get-thread	获取有关通知线程的信息
mark-thread-read	将特定线程标记为已读
mark-thread-done	将线程标记为完成
get-thread-subscription	获取线程的订阅状态
set-thread-subscription	订阅线程
delete-thread-subscription	取消订阅线程
list-repo-notifications	列出特定仓库的通知
mark-repo-notifications-read	将仓库的通知标记为已读
manage-repo-subscription	管理仓库订阅：all_activity、default (participating and @mentions) 或 ignore (mute)

示例提示

以下是一些您可以与 Claude Desktop 一起使用的示例提示，一旦服务器连接：

• "你能检查我的 GitHub 通知吗？"
• "显示我过去 24 小时内未读的通知。"
• "将我的所有通知标记为已读。"
• "你能告诉我关于通知线程 12345 的信息吗？"
• "取消订阅线程 12345。"
• "我在 octocat/Hello-World 仓库有哪些通知？"
• "将来自 octocat/Hello-World 仓库的所有通知标记为已读。"
• "关注 octocat/Hello-World 仓库上的所有活动。"
• "将 octocat/Hello-World 仓库设置为默认设置（参与和 @提及）。"
• "检查我在 octocat/Hello-World 仓库的通知设置。"
• "静音来自 octocat/Hello-World 仓库的所有通知。"

开发

URL 处理

此服务器自动将 GitHub API URL 转换为其对应的 Web UI URL。例如：

• API URL: https://api.github.com/repos/nodejs/node/pulls/57557
• 转换为: https://github.com/nodejs/node/pull/57557

转换处理：

• 将域名从 api.github.com/repos 转换为 github.com
• 修正拉取请求的路径（将 pulls 更改为 pull）
• 保留其他路径段

项目结构

github-notifications-mcp-server/
├── src/                    # 源代码
│   ├── tools/              # 工具实现
│   ├── types/              # 类型定义
│   ├── utils/              # 实用函数
│   ├── index.ts            # 入口点
│   └── server.ts           # 服务器配置
├── build/                  # 编译后的 JavaScript
├── .env                    # 环境变量
├── package.json            # 依赖项
├── tsconfig.json           # TypeScript 配置
└── README.md               # 文档

构建

npm run build

测试

运行自动化测试：

npm test

手动测试 URL 转换：

npm run test:url

许可证

MIT