Gitea MCP Tool

/** * Issue 管理命令 */ import { createClient, createContextManager, resolveOwnerRepo, ClientOptions } from '../utils/client.js'; import { success, error, outputDetails, outputList, info } from '../utils/output.js'; import { createIssue, getIssue, listIssues, updateIssue, closeIssue, commentIssue, listIssueComments, getIssueComment, editIssueComment, deleteIssueComment, listIssueDependencies, addIssueDependency, removeIssueDependency, listIssueBlocks, } from '../../tools/issue.js'; /** * 列出 Issues */ export async function issueList(options: ClientOptions & { owner?: string; repo?: string; state?: string; limit?: string; page?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await listIssues({ client, contextManager }, { owner, repo, state: options.state as 'open' | 'closed' | 'all', limit: parseInt(options.limit || '20'), page: parseInt(options.page || '1'), }); if (result.issues.length === 0) { info('没有找到 Issues', options); return; } const issues = result.issues.map((issue: any) => ({ '#': issue.number, title: issue.title, state: issue.state, author: issue.user?.login || '-', comments: issue.comments, updated: issue.updated_at?.split('T')[0] || '-', })); outputList(issues, options); } catch (err: any) { error(`列出 Issues 失败: ${err.message}`); process.exit(1); } } /** * 获取 Issue 详情 */ export async function issueGet(index: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await getIssue({ client, contextManager }, { owner, repo, index }); const issue = result.issue; outputDetails({ number: issue.number, title: issue.title, state: issue.state, author: issue.user?.login || '-', assignees: issue.assignees?.map((a: any) => a.login).join(', ') || '-', labels: issue.labels?.map((l: any) => l.name).join(', ') || '-', milestone: issue.milestone?.title || '-', comments: issue.comments, created: issue.created_at?.split('T')[0], updated: issue.updated_at?.split('T')[0], body: issue.body || '(无内容)', url: issue.html_url, }, options); } catch (err: any) { error(`获取 Issue 详情失败: ${err.message}`); process.exit(1); } } /** * 创建 Issue */ export async function issueCreate(options: ClientOptions & { owner?: string; repo?: string; title: string; body?: string; assignees?: string[]; labels?: string[]; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await createIssue({ client, contextManager }, { owner, repo, title: options.title, body: options.body, assignees: options.assignees, labels: options.labels?.map(id => parseInt(id)), }); success(`Issue 创建成功: #${result.issue.number}`, options); outputDetails({ number: result.issue.number, title: result.issue.title, url: result.issue.html_url, }, options); } catch (err: any) { error(`创建 Issue 失败: ${err.message}`); process.exit(1); } } /** * 更新 Issue */ export async function issueUpdate(index: number, options: ClientOptions & { owner?: string; repo?: string; title?: string; body?: string; state?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await updateIssue({ client, contextManager }, { owner, repo, index, title: options.title, body: options.body, state: options.state as 'open' | 'closed', }); success(`Issue 更新成功: #${result.issue.number}`, options); outputDetails({ number: result.issue.number, title: result.issue.title, state: result.issue.state, }, options); } catch (err: any) { error(`更新 Issue 失败: ${err.message}`); process.exit(1); } } /** * 关闭 Issue */ export async function issueClose(index: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await closeIssue({ client, contextManager }, { owner, repo, index }); success(`Issue #${result.issue.number} 已关闭`, options); } catch (err: any) { error(`关闭 Issue 失败: ${err.message}`); process.exit(1); } } /** * 添加 Issue 评论 */ export async function issueComment(index: number, options: ClientOptions & { owner?: string; repo?: string; body: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await commentIssue({ client, contextManager }, { owner, repo, index, body: options.body, }); success(`评论添加成功`, options); outputDetails({ id: result.comment.id, author: result.comment.user?.login || '-', body: result.comment.body, created: result.comment.created_at?.split('T')[0], }, options); } catch (err: any) { error(`添加评论失败: ${err.message}`); process.exit(1); } } /** * 列出 Issue 评论 */ export async function issueCommentsList(index: number, options: ClientOptions & { owner?: string; repo?: string; limit?: string; page?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await listIssueComments({ client, contextManager }, { owner, repo, index, limit: parseInt(options.limit || '30'), page: parseInt(options.page || '1'), }); if (result.comments.length === 0) { info(`Issue #${index} 没有评论`, options); return; } const comments = result.comments.map((comment: any) => ({ 'ID': comment.id, author: comment.user?.login || '-', body: comment.body.length > 50 ? comment.body.substring(0, 50) + '...' : comment.body, created: comment.created_at?.split('T')[0] || '-', })); outputList(comments, options); } catch (err: any) { error(`列出评论失败: ${err.message}`); process.exit(1); } } /** * 获取评论详情 */ export async function issueCommentGet(id: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await getIssueComment({ client, contextManager }, { owner, repo, id }); const comment = result.comment; outputDetails({ id: comment.id, author: comment.user?.login || '-', body: comment.body, created: comment.created_at?.split('T')[0], updated: comment.updated_at?.split('T')[0], url: comment.html_url, }, options); } catch (err: any) { error(`获取评论详情失败: ${err.message}`); process.exit(1); } } /** * 编辑评论 */ export async function issueCommentEdit(id: number, options: ClientOptions & { owner?: string; repo?: string; body: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await editIssueComment({ client, contextManager }, { owner, repo, id, body: options.body, }); success(`评论 #${result.comment.id} 编辑成功`, options); outputDetails({ id: result.comment.id, body: result.comment.body, updated: result.comment.updated_at?.split('T')[0], }, options); } catch (err: any) { error(`编辑评论失败: ${err.message}`); process.exit(1); } } /** * 删除评论 */ export async function issueCommentDelete(id: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); await deleteIssueComment({ client, contextManager }, { owner, repo, id }); success(`评论 #${id} 已删除`, options); } catch (err: any) { error(`删除评论失败: ${err.message}`); process.exit(1); } } /** * 列出 Issue 依赖列表 */ export async function issueDeps(index: number, options: ClientOptions & { owner?: string; repo?: string; limit?: string; page?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await listIssueDependencies({ client, contextManager }, { owner, repo, index, limit: parseInt(options.limit || '30'), page: parseInt(options.page || '1'), }); if (result.dependencies.length === 0) { info(`Issue #${index} 没有依赖其他 Issue`, options); return; } const deps = result.dependencies.map((dep: any) => ({ '#': dep.number, title: dep.title, state: dep.state, author: dep.user?.login || '-', updated: dep.updated_at?.split('T')[0] || '-', })); outputList(deps, options); } catch (err: any) { error(`获取依赖列表失败: ${err.message}`); process.exit(1); } } /** * 添加 Issue 依赖 */ export async function issueDepAdd(index: number, dependencyIndex: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await addIssueDependency({ client, contextManager }, { owner, repo, index, dependencyIndex, }); success(`依赖添加成功: Issue #${index} 现在依赖 #${dependencyIndex}`, options); outputDetails({ issue: `#${result.issue.number} - ${result.issue.title}`, dependency: `#${result.dependency.number} - ${result.dependency.title}`, }, options); } catch (err: any) { error(`添加依赖失败: ${err.message}`); process.exit(1); } } /** * 移除 Issue 依赖 */ export async function issueDepRemove(index: number, dependencyIndex: number, options: ClientOptions & { owner?: string; repo?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); await removeIssueDependency({ client, contextManager }, { owner, repo, index, dependencyIndex, }); success(`依赖移除成功: Issue #${index} 不再依赖 #${dependencyIndex}`, options); } catch (err: any) { error(`移除依赖失败: ${err.message}`); process.exit(1); } } /** * 列出依赖当前 Issue 的其他 Issue（被依赖列表/反向查询） */ export async function issueBlocks(index: number, options: ClientOptions & { owner?: string; repo?: string; limit?: string; page?: string; }) { try { const client = await createClient(options); const contextManager = await createContextManager(client, options); const { owner, repo } = resolveOwnerRepo(contextManager, options); const result = await listIssueBlocks({ client, contextManager }, { owner, repo, index, limit: parseInt(options.limit || '30'), page: parseInt(options.page || '1'), }); if (result.blocks.length === 0) { info(`没有其他 Issue 依赖 #${index}`, options); return; } const blocks = result.blocks.map((block: any) => ({ '#': block.number, title: block.title, state: block.state, author: block.user?.login || '-', updated: block.updated_at?.split('T')[0] || '-', })); outputList(blocks, options); } catch (err: any) { error(`获取被依赖列表失败: ${err.message}`); process.exit(1); } }