search_issues
Search for Redmine issues by keyword in titles or descriptions, filter results by project, and control output with a limit parameter to retrieve relevant project management data efficiently.
Instructions
搜尋議題 (在標題或描述中搜尋關鍵字)
Args:
query: 搜尋關鍵字
project_id: 限制在特定專案中搜尋 (可選)
limit: 最大回傳數量 (預設 10，最大 50)
Returns:
符合搜尋條件的議題列表
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| project_id | No | ||
| query | Yes |
Implementation Reference
- src/redmine_mcp/server.py:446-514 (handler)Implementation of the search_issues MCP tool. The @mcp.tool() decorator registers it, the function handles searching Redmine issues by keyword in title/description, optionally scoped to a project, with result limit. Includes input validation, client interaction, local filtering, and formatted table output.@mcp.tool() def search_issues(query: str, project_id: int = None, limit: int = 10) -> str: """ 搜尋議題 (在標題或描述中搜尋關鍵字) Args: query: 搜尋關鍵字 project_id: 限制在特定專案中搜尋 (可選) limit: 最大回傳數量 (預設 10，最大 50) Returns: 符合搜尋條件的議題列表 """ try: if not query.strip(): return "請提供搜尋關鍵字" client = get_client() limit = min(max(limit, 1), 50) # 設定搜尋參數 params = { 'limit': limit * 3, # 取得更多結果以便篩選 'sort': 'updated_on:desc' } if project_id: params['project_id'] = project_id # 取得議題列表 all_issues = client.list_issues(**params) # 在本地端進行關鍵字篩選 (因為 Redmine API 沒有內建搜尋) query_lower = query.lower() matching_issues = [] for issue in all_issues: if (query_lower in issue.subject.lower() or (issue.description and query_lower in issue.description.lower())): matching_issues.append(issue) if len(matching_issues) >= limit: break if not matching_issues: search_scope = f"專案 {project_id}" if project_id else "所有可存取的專案" return f"在 {search_scope} 中沒有找到包含 '{query}' 的議題" # 格式化結果 result = f"搜尋關鍵字: '{query}'\n" if project_id: result += f"搜尋範圍: 專案 {project_id}\n" result += f"找到 {len(matching_issues)} 個相關議題:\n\n" result += f"{'ID':<8} {'標題':<35} {'狀態':<12} {'專案':<15}\n" result += f"{'-'*8} {'-'*35} {'-'*12} {'-'*15}\n" for issue in matching_issues: title = issue.subject[:32] + "..." if len(issue.subject) > 35 else issue.subject status = issue.status.get('name', 'N/A')[:10] project_name = issue.project.get('name', 'N/A')[:13] result += f"{issue.id:<8} {title:<35} {status:<12} {project_name:<15}\n" return result except RedmineAPIError as e: return f"搜尋議題失敗: {str(e)}" except Exception as e: return f"系統錯誤: {str(e)}"