Gitea MCP Tool

Instructions

Implementation Reference

• src/tools/workflow.ts:594-701 (handler)

  The core handler function for 'gitea_workflow_check_blocked'. It fetches open issues, calculates time since update, checks against SLA hours per priority from config, and specific conditions for 'needs-info' and 'needs-review' labels. Returns list of newly blocked issues.
  export async function workflowCheckBlocked( ctx: WorkflowToolsContext, args: { owner?: string; repo?: string; config?: WorkflowConfig; threshold_hours?: number; } ): Promise<{ success: boolean; blocked_issues: Array<{ number: number; title: string; priority: string | null; hours_since_update: number; sla_hours: number | null; reason: string; }>; error?: string; }> { logger.debug({ args: { ...args, config: args.config ? '[provided]' : undefined } }, 'Checking blocked issues'); const { owner, repo } = ctx.contextManager.resolveOwnerRepo(args.owner, args.repo); // 获取配置 let config = args.config; if (!config) { const loadResult = await workflowLoadConfig(ctx, { owner, repo }); if (!loadResult.success || !loadResult.config) { return { success: false, blocked_issues: [], error: loadResult.error || '无法加载配置', }; } config = loadResult.config; } const blockedIssues: Array<{ number: number; title: string; priority: string | null; hours_since_update: number; sla_hours: number | null; reason: string; }> = []; try { // 获取开放的 Issue const issues = await ctx.client.get<Issue[]>(`/repos/${owner}/${repo}/issues?state=open&limit=100`); for (const issue of issues) { const priority = getIssuePriority(issue); const hoursSinceUpdate = calculateHoursSinceUpdate(issue); const slaHours = priority ? getSLAHours(config, priority) : null; // 检查是否已有阻塞标签 const prefixes = getLabelPrefixes(config); const blockedLabel = buildLabel(prefixes.workflow, 'blocked'); const alreadyBlocked = hasLabel(issue, blockedLabel); // 检查是否超过 SLA let isBlocked = false; let reason = ''; if (args.threshold_hours && hoursSinceUpdate > args.threshold_hours) { isBlocked = true; reason = `超过指定阈值 ${args.threshold_hours} 小时未更新`; } else if (slaHours && hoursSinceUpdate > slaHours) { isBlocked = true; reason = `超过 SLA 时间 (${slaHours} 小时)`; } else if (hasLabel(issue, buildLabel(prefixes.workflow, 'needs-info')) && hoursSinceUpdate > 48) { isBlocked = true; reason = '标记为需要信息但超过 48 小时未响应'; } else if (hasLabel(issue, buildLabel(prefixes.workflow, 'needs-review')) && hoursSinceUpdate > 72) { isBlocked = true; reason = '标记为需要审查但超过 72 小时未处理'; } if (isBlocked && !alreadyBlocked) { blockedIssues.push({ number: issue.number, title: issue.title, priority, hours_since_update: hoursSinceUpdate, sla_hours: slaHours ?? null, reason, }); } } logger.info({ owner, repo, blocked: blockedIssues.length }, 'Blocked issues checked'); return { success: true, blocked_issues: blockedIssues, }; } catch (error) { const errorMessage = error instanceof Error ? error.message : String(error); logger.error({ owner, repo, error: errorMessage }, 'Failed to check blocked issues'); return { success: false, blocked_issues: [], error: errorMessage, }; } }
• src/tools-registry/workflow-registry.ts:221-251 (registration)

  Tool registration in MCP server, including title, description, input schema using Zod, and wrapper handler that calls the core workflowCheckBlocked function.
  mcpServer.registerTool( 'gitea_workflow_check_blocked', { title: '检测阻塞 Issue', description: 'Detect issues that are blocked or exceeding SLA. Checks for stale issues based on priority-specific time limits.', inputSchema: z.object({ owner: z.string().optional().describe('Repository owner. Uses context if not provided'), repo: z.string().optional().describe('Repository name. Uses context if not provided'), threshold_hours: z.number().optional().describe('Override default SLA hours threshold'), }), }, async (args) => { try { const result = await WorkflowTools.workflowCheckBlocked( { client: ctx.client, contextManager: ctx.contextManager }, args ); return { content: [{ type: 'text' as const, text: JSON.stringify(result, null, 2) }], isError: !result.success, }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : String(error); return { content: [{ type: 'text' as const, text: `Error: ${errorMessage}` }], isError: true, }; } } );
• src/tools-registry/workflow-registry.ts:227-230 (schema)

  Zod input schema definition for the tool parameters: owner, repo (optional), threshold_hours (optional override).
  inputSchema: z.object({ owner: z.string().optional().describe('Repository owner. Uses context if not provided'), repo: z.string().optional().describe('Repository name. Uses context if not provided'), threshold_hours: z.number().optional().describe('Override default SLA hours threshold'),