searchIssues
Search for Backlog issues by project ID, keywords, and status to find specific tickets and track progress in project management workflows.
Instructions
Backlogの課題を検索します
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | No | 検索キーワード | |
| projectId | Yes | プロジェクトID（数値） | |
| status | No | ステータス（未対応、処理中、処理済み、完了） |
Implementation Reference
- src/index.ts:125-142 (handler)MCP tool handler for 'searchIssues': validates input arguments and calls BacklogClient.searchIssues, returning JSON response.case 'searchIssues': { const args = this.validateAndCastArguments<SearchIssuesArgs>( request.params.arguments, searchIssuesSchema ); return { content: [ { type: 'text', text: JSON.stringify( await this.backlogClient.searchIssues(args), null, 2 ), }, ], }; }
- src/index.ts:89-93 (registration)Registers the 'searchIssues' tool in the MCP server's listTools response with name, description, and schema.{ name: 'searchIssues', description: 'Backlogの課題を検索します', inputSchema: searchIssuesSchema, },
- src/backlog/schemas.ts:4-24 (schema)Defines the JSON schema for searchIssues tool input parameters.export const searchIssuesSchema = { type: 'object', properties: { projectId: { type: 'number', description: 'プロジェクトID（数値）', }, keyword: { type: 'string', description: '検索キーワード', }, status: { type: 'array', items: { type: 'string', }, description: 'ステータス（未対応、処理中、処理済み、完了）', }, }, required: ['projectId'], } as const;
- src/backlog/client.ts:33-49 (helper)BacklogClient method that performs the actual HTTP request to search issues using Backlog API.async searchIssues(args: SearchIssuesArgs): Promise<BacklogIssue[]> { try { const response = await this.client.get('/issues', { params: { 'projectId[]': [args.projectId], keyword: args.keyword, 'statusId[]': args.status?.map(this.getStatusId), }, }); return response.data; } catch (error) { if (axios.isAxiosError(error)) { throw new Error(`Backlog API error: ${error.response?.data.message ?? error.message}`); } throw error; } }
- src/backlog/schemas.ts:85-89 (schema)TypeScript interface defining the arguments for searchIssues.export interface SearchIssuesArgs { projectId: number; keyword?: string; status?: string[]; }