AI 코딩 에이전트를 위한 에이전트 작업 기반입니다. GitHub Projects v2를 완전 자율적인 프로젝트 관리 플랫폼으로 전환하는 MCP 서버입니다 — AI 에이전트는 작업을 스스로 할당하고, 진행 상황을 추적하며, 서로를 검토하고 코드를 배포하며, 모두 GitHub 네이티브 스토리지로 뒷받침됩니다.

사용 사례: AI 에이전트(클로드 코드, 코덱스, 커서, 윈드서프, 루)가 있습니다. 그들은 작업 뼈대가 필요합니다. 이것이 바로 그것입니다.

개요

이 MCP 서버는 모델 컨텍스트 프로토콜을 구현하여 GitHub Projects v2 위에 완전한 에이전트 프로젝트 관리 계층을 제공합니다. AI 에이전트는 등록, 자체 할당, 하트비트 조준, 작업 산출물 제출, 토큰 예산 내에서 작동합니다 — 20개의 복합 도구를 통해 169개의 액션을 노출합니다. 인간 프로젝트 매니저는 AI 기반 PRD 생성, 스프린트 계획, 이슈 트리지, 로드맵 생성 등을 제공합니다. 모든 것은 GitHub 네이티브 스토리지(이슈, 프로젝트 필드, 댓글)로 지원되며, 외부 인프라가 필요하지 않습니다.

왜 이런 것이 존재하는가

AI 코딩 에이전트는 강력하지만 상태가 없습니다 — 다음에 무엇을 해야 할지 모르고, 다른 에이전트와 협력할 수 없으며, 지속적인 작업 메모리가 없습니다.

MCP GitHub Project Manager

The task substrate for AI coding agents. An MCP server that turns GitHub Projects v2 into an agentic project-management layer: agents register, self-assign work, heartbeat, submit work products for review, and spend against token budgets — through 20 compound tools exposing 169 actions, backed entirely by GitHub-native storage. No database, no Redis, no external infra.

You bring the agents (Claude Code, Codex, Cursor, Windsurf, Roo, OpenCode, any MCP client). This is the backbone that tells them what to work on and keeps them from colliding.

Why this exists

• Agents need a work queue, not a chat window. agent_work / agent_manage give agents atomic task checkout, heartbeats, and a review loop instead of “go figure it out.”
• Budgets must be enforced somewhere the agent cannot skip. Each agent has a token budget with warning thresholds and a hard stop; the server debits itself, and record_usage covers the agent’s own runtime spend.
• AI plans are worthless if they never become issues. ai_generate runs idea → PRD → tasks → materialized GitHub issues, grouped into milestones and sprints.
• Tool lists are a context tax. 20 tools instead of 169 keeps the schema small; discover_tools expands any domain or action on demand.
• State should live where the work already is. The agent registry is a file on a dedicated branch (compare-and-swap writes), task claims are project fields, work products are issue comments — no new infrastructure to operate.

Quick start

Requires Node.js >= 22.12.0 (Node 24 recommended).

# 1. Install (global, or use npx / pnpm dlx / docker compose — see below)
npm install -g mcp-github-project-manager

# 2. Configure (a working `gh auth login` means you can skip GITHUB_TOKEN)
export GITHUB_TOKEN="ghp_..."
export GITHUB_OWNER="your-org-or-user"
export GITHUB_REPO="your-repo"