用 mcp-github-project-manager 把 GitHub Projects v2 变成多 Agent 任务队列：注册领活、心跳与预算硬闸实操

# 确认运行时版本
node --version

# 路线 A：全局安装（官方 Quickstart）
npm install -g mcp-github-project-manager

# 路线 B：npx 即用（客户端配置里最常用）
npx -y mcp-github-project-manager

# 路线 C：pnpm dlx
pnpm dlx mcp-github-project-manager

# 路线 D：容器
docker compose up --build

# 全局安装后直接启动 stdio server
mcp-github-project-manager

# 方式一：环境变量（Quickstart 写法）
export GITHUB_TOKEN="ghp_..."
export GITHUB_OWNER="your-org-or-user"
export GITHUB_REPO="your-repo"

# 方式二：复用 gh CLI 登录态，无需自建 PAT
mcp-github-project-manager auth login --gh
gh auth refresh -h github.com -s project

# 方式三：OAuth 设备流
GITHUB_OAUTH_CLIENT_ID=... mcp-github-project-manager auth login

# Claude Code CLI 一行接入
claude mcp add github-project-manager -- npx -y mcp-github-project-manager

{
  "mcpServers": {
    "github-project-manager": {
      "command": "npx",
      "args": ["-y", "mcp-github-project-manager"],
      "env": {
        "GITHUB_TOKEN": "ghp_...",
        "GITHUB_OWNER": "your-org-or-user",
        "GITHUB_REPO": "your-repo"
      }
    }
  }
}

{
  "tool": "agent_work",
  "arguments": {
    "action": "register",
    "name": "claude-eng-1",
    "role": "engineer",
    "runtime": "claude-code",
    "capabilities": ["typescript", "testing"]
  }
}

{
  "tool": "agent_work",
  "arguments": {
    "action": "checkout_task",
    "agentId": "agent-abc123",
    "strategy": "highest_priority"
  }
}

{
  "tool": "agent_work",
  "arguments": {
    "action": "get_task_context",
    "issueNumber": 42
  }
}

{
  "tool": "agent_work",
  "arguments": {
    "action": "heartbeat",
    "agentId": "agent-abc123",
    "status": "working",
    "taskId": "issue-42",
    "progress": 60,
    "currentBranch": "feat/42-add-login-form"
  }
}

{
  "tool": "agent_manage",
  "arguments": {
    "action": "submit_work_product",
    "agentId": "agent-abc123",
    "taskId": "issue-42",
    "issueNumber": 42,
    "branch": "feat/42-add-login-form",
    "prNumber": 99,
    "summary": "Added login form with validation"
  }
}

{
  "tool": "agent_work",
  "arguments": {
    "action": "complete_task",
    "agentId": "agent-abc123",
    "taskId": "issue-42",
    "summary": "Implemented and tested"
  }
}

# 设置预算的工具与动作（参数细节见 docs/TOOLS.md）
# tool: agent_manage
# action: set_budget
# reset period: daily | weekly | monthly | never

# 与单次操作预算区分开
# AI_SESSION_TOKEN_LIMIT 是「每次 AI 任务生成」的上限
# 与 per-agent 预算是两套独立机制

# 只暴露必要工具组，减小上下文开销
MCP_TOOL_GROUPS=core
MCP_TOOL_GROUPS=core,ai
MCP_TOOL_GROUPS=all

# 按需展开动作，而不是把 175 个动作全塞进 schema
# {"tool": "discover_tools", "arguments": {"domain": "sprints"}}

# 打开 AI 工具组（默认 all 时无需设置）
MCP_TOOL_GROUPS=core,ai

# 按角色配置模型（官方变量形态）
# AI_{MAIN,PRD,RESEARCH,FALLBACK}_{PROVIDER,MODEL,API_KEY,BASE_URL}
# 例：AI_PRD_PROVIDER、AI_PRD_MODEL、AI_PRD_API_KEY

# 打开变更审计：追加式、已脱敏的 JSONL
AUDIT_LOG_ENABLED=true
AUDIT_LOG_PATH=.mcp-audit/mutations.jsonl

# 健康与速率
# system 组提供实时 GitHub 速率探测的健康检查
RATE_LIMIT_FLOOR=100