create_issue
Generate and manage new work items such as tasks, defects, requirements, or epics in CODING DevOps projects by specifying title, description, priority, and type using standardized MCP protocols.
Instructions
创建新的工作项
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | 事项描述 | |
| name | Yes | 事项标题 | |
| priority | Yes | 优先级，可选值为：0 - 低 1 - 中 2 - 高 3 - 紧急 | |
| projectName | Yes | 项目名称 | |
| type | Yes | 事项类型，可选值为： DEFECT - 缺陷 REQUIREMENT - 需求 MISSION - 任务 EPIC - 史诗 |
Implementation Reference
- src/tools/issue/create.ts:5-58 (handler)The main handler function that performs input validation, initializes the CodingConnection, calls the low-level API to create the issue, and returns a formatted MCP response.export async function createIssue(args: { projectName: string; name: string; type: string; priority: string; description: string; parentCode?: number; }, config: CodingDevOpsConfig) { if (!args.projectName) { throw new McpError(ErrorCode.InvalidParams, 'projectName01 is required'); } if (!args.name) { throw new McpError(ErrorCode.InvalidParams, 'Name is required'); } if (!args.type) { throw new McpError(ErrorCode.InvalidParams, 'Type is required'); } if (!args.priority) { throw new McpError(ErrorCode.InvalidParams, 'Priority is required'); } if (!args.description) { throw new McpError(ErrorCode.InvalidParams, 'Description is required'); } // 验证事项类型 const validTypes = ['DEFECT', 'REQUIREMENT', 'MISSION', 'EPIC']; if (!validTypes.includes(args.type)) { throw new McpError( ErrorCode.InvalidParams, `Invalid type. Must be one of: ${validTypes.join(', ')}` ); } CodingConnection.initialize(config); const connection = CodingConnection.getInstance(); const issue = await connection.createIssue({ projectName: args.projectName, name: args.name, type: args.type, priority: args.priority, description: args.description, parentCode: args.parentCode }); return { content: [ { type: 'text', text: `Successfully created issue: ${issue.Name} (${issue.Code})`, }, ], }; }
- src/tools/issue/index.ts:32-65 (schema)Input schema and metadata definition for the 'create_issue' tool used for tool listing and validation.{ name: 'create_issue', description: '创建新的工作项', inputSchema: { type: 'object', properties: { projectName: { type: 'string', description: '项目名称', }, name: { type: 'string', description: '事项标题', }, type: { type: 'string', description: '事项类型，可选值为： DEFECT - 缺陷 REQUIREMENT - 需求 MISSION - 任务 EPIC - 史诗', }, priority: { type: 'string', description: '优先级，可选值为：0 - 低 1 - 中 2 - 高 3 - 紧急', }, description: { type: 'string', description: '事项描述', }, parentCode: { type: 'number', description: '父事项编号，如果设置了此字段，创建的事项将成为该父事项的子事项', } }, required: ['projectName', 'name', 'type', 'priority', 'description'], } },
- src/index.ts:121-122 (registration)Registration in the main MCP server request handler: switch case that dispatches 'create_issue' calls to the tool implementation.case 'create_issue': result = await tools.issue.createIssue(request.params.arguments);
- src/tools/issue/index.ts:151-158 (registration)Tool instance registration in issueTools module: typed wrapper that passes config to the createIssue handler.createIssue: (args: { projectName: string; name: string; type: string; priority: string; description: string; parentCode?: number; }) => createIssue(args, config),
- src/api/coding_connection.ts:228-264 (helper)Low-level helper method in CodingConnection that performs the actual HTTP API call to create the issue.public async createIssue(params: { projectName: string; name: string; type: string; priority: string; description: string; parentCode?: number; }): Promise<CodingIssue> { const requestBody = { Action: 'CreateIssue', ProjectName: params.projectName, Name: params.name, Type: params.type, Priority: params.priority, Description: params.description, ParentCode: params.parentCode }; const response = await axios.post<{ Response: { Issue: CodingIssue; RequestId: string; }; }>( CodingConnection.config.apiUrl, requestBody, { headers: { 'Authorization': `token ${CodingConnection.config.token}`, 'Content-Type': 'application/json', 'Accept': 'application/json' } } ); return response.data.Response.Issue; }