gh-board-mcp

GitHub Projects v2를 개인 칸반 보드로 관리하기 위한 MCP 서버입니다. 실제 이슈에 연결하지 않고 활동(초안 항목)을 만들고, 열 사이로 이동시키며, 우선순위를 추적합니다 — 실제 이슈에 연결하지 않고.

요구 사항

• Node.js >= 18

• project 범위가 있는 GitHub Personal Access Token(세분화된 토큰: Projects 읽기/쓰기)

Related MCP server: GitHub Projects MCP Server

사용법

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

MCP 클라이언트(예: Claude Code)에서 구성하세요:

claude mcp add gh-board-mcp -- env GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

도구

상태 및 우선순위

• create_project는 Status = Todo / In Progress / Done, Priority = Urgent / High / Medium / Low인 새 보드를 생성합니다.

• GitHub 템플릿에서 생성된 보드는 자체 Status/Priority 옵션을 유지합니다 — 보드에 존재하는 값을 전달하세요. create_activity, move_activity, list_activities는 알 수 없는 값이 주어지면 유효한 옵션을 보고합니다.

• 사용자 지정 열은 API를 통해 지원되지 않습니다(GitHub UI에서 구성하세요).

참고 사항

• 읽기 한도: list_activities 및 list_projects는 한 번의 호출로 최대 100개 항목/프로젝트를 읽습니다. 더 큰 보드는 잘립니다.

• 최종 일관성: GitHub Projects v2 쓰기는 읽기에 반영되는 데 시간이 걸릴 수 있습니다. create_activity 직후의 list_activities는 새 항목을 잠시 놓칠 수 있습니다.

• 생성은 원자적이지 않음: create_activity는 생성 전에 상태/우선순위 옵션을 검증하므로 잘못된 옵션은 아무것도 남기지 않습니다. 하지만 생성 중간에 일시적인 네트워크 오류가 발생하면 필드 값이 없는 초안이 남을 수 있습니다.

개발

npm install
npm test
npm run build
npm run dev

라이선스

MIT