list_project_issues
Retrieve and filter issues from a Redmine project by status, displaying results in a table format for project management tracking.
Instructions
列出專案的議題
Args:
project_id: 專案 ID
status_filter: 狀態篩選 ("open", "closed", "all")
limit: 最大回傳數量 (預設 20，最大 100)
Returns:
專案議題列表，以表格格式呈現Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| status_filter | No | open | |
| limit | No |
Implementation Reference
- src/redmine_mcp/server.py:189-256 (handler)The complete implementation of the 'list_project_issues' tool handler. It is registered via the @mcp.tool() decorator. The function fetches issues from a Redmine project using the Redmine client, applies filters, and formats them into a readable table.
@mcp.tool() def list_project_issues(project_id: int, status_filter: str = "open", limit: int = 20) -> str: """ 列出專案的議題 Args: project_id: 專案 ID status_filter: 狀態篩選 ("open", "closed", "all") limit: 最大回傳數量 (預設 20，最大 100) Returns: 專案議題列表，以表格格式呈現 """ try: client = get_client() # 限制 limit 範圍 limit = min(max(limit, 1), 100) # 根據狀態篩選設定參數 params = { 'project_id': project_id, 'limit': limit, 'sort': 'updated_on:desc' } # 處理狀態篩選 if status_filter == "open": params['status_id'] = 'o' # Redmine API 使用 'o' 表示開放狀態 elif status_filter == "closed": params['status_id'] = 'c' # Redmine API 使用 'c' 表示關閉狀態 # "all" 則不設定 status_id # 取得議題列表 issues = client.list_issues(**params) if not issues: return f"專案 {project_id} 中沒有找到符合條件的議題" # 取得專案資訊 try: project = client.get_project(project_id) project_name = project.name except: project_name = f"專案 {project_id}" # 格式化議題列表 result = f"""專案: {project_name} 狀態篩選: {status_filter} 找到 {len(issues)} 個議題: {"ID":<8} {"標題":<40} {"狀態":<12} {"指派給":<15} {"更新時間":<10} {"-"*8} {"-"*40} {"-"*12} {"-"*15} {"-"*10}""" for issue in issues: title = issue.subject[:37] + "..." if len(issue.subject) > 40 else issue.subject status = issue.status.get('name', 'N/A')[:10] assignee = issue.assigned_to.get('name', '未指派')[:13] if issue.assigned_to else '未指派' updated = issue.updated_on[:10] if issue.updated_on else 'N/A' result += f"\n{issue.id:<8} {title:<40} {status:<12} {assignee:<15} {updated:<10}" return result except RedmineAPIError as e: return f"列出專案議題失敗: {str(e)}" except Exception as e: return f"系統錯誤: {str(e)}"