Redmine MCP Server

Instructions

列出專案的議題

Args:
    project_id: 專案 ID
    status_filter: 狀態篩選 ("open", "closed", "all")
    limit: 最大回傳數量 (預設 20，最大 100)

Returns:
    專案議題列表，以表格格式呈現

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)}"