remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

GitHub 알림 MCP 서버

GitHub 알림 관리 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 사용하면 Claude와 같은 AI 도우미가 자연어 명령을 통해 GitHub 알림을 관리할 수 있습니다.

특징

GitHub 알림을 나열하고 필터링하세요
알림을 읽음으로 표시
알림 스레드 세부 정보 보기
알림 스레드 구독 또는 구독 취소
스레드를 완료로 표시
저장소별 알림 관리
저장소 알림 설정 제어(모든 활동, 기본값 또는 음소거)

필수 조건

Node.js 18 이상
notifications 또는 repo 범위가 포함된 GitHub 개인 액세스 토큰(클래식)

설치

이 저장소를 복제하세요지엑스피1
종속성 설치
npm install
프로젝트를 빌드하세요
npm run build
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(참여 및 @mentions), 또는 ignore(음소거)

예시 프롬프트

서버가 연결되면 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을 해당 웹 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/                    # Source code
│   ├── tools/              # Tool implementations
│   ├── types/              # Type definitions
│   ├── utils/              # Utility functions
│   ├── index.ts            # Entry point
│   └── server.ts           # Server configuration
├── build/                  # Compiled JavaScript
├── .env                    # Environment variables
├── package.json            # Dependencies
├── tsconfig.json           # TypeScript configuration
└── README.md               # Documentation

건물

npm run build

테스트

자동화된 테스트를 실행합니다.

npm test

URL 변환을 수동으로 테스트하세요.

npm run test:url

특허

MIT

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude와 같은 AI 도우미가 자연어 명령을 통해 사용자가 GitHub 알림을 관리할 수 있도록 돕는 MCP 서버입니다.

GitHub Notifications MCP Server