Redmine MCP Server

Instructions

建立新的 Redmine 議題

Args:
    project_id: 專案 ID
    subject: 議題標題
    description: 議題描述（可選）
    tracker_id: 追蹤器 ID（與 tracker_name 二選一）
    tracker_name: 追蹤器名稱（與 tracker_id 二選一）
    priority_id: 優先級 ID（與 priority_name 二選一）
    priority_name: 優先級名稱（與 priority_id 二選一）
    assigned_to_id: 指派給的用戶 ID（與 assigned_to_name/assigned_to_login 三選一）
    assigned_to_name: 指派給的用戶姓名（與 assigned_to_id/assigned_to_login 三選一）
    assigned_to_login: 指派給的用戶登入名（與 assigned_to_id/assigned_to_name 三選一）

Returns:
    建立結果訊息

Implementation Reference

• src/redmine_mcp/server.py:812-899 (handler)

  The core handler function for the 'create_new_issue' tool. Decorated with @mcp.tool() for MCP registration. Resolves optional parameters by name to IDs using client helpers, creates the issue via Redmine client, fetches the new issue details, and returns a formatted success message with error handling.

  @mcp.tool()
  def create_new_issue(project_id: int, subject: str, description: str = "", 
                      tracker_id: int = None, tracker_name: str = None,
                      priority_id: int = None, priority_name: str = None,
                      assigned_to_id: int = None, assigned_to_name: str = None, assigned_to_login: str = None) -> str:
      """
      建立新的 Redmine 議題
      
      Args:
          project_id: 專案 ID
          subject: 議題標題
          description: 議題描述（可選）
          tracker_id: 追蹤器 ID（與 tracker_name 二選一）
          tracker_name: 追蹤器名稱（與 tracker_id 二選一）
          priority_id: 優先級 ID（與 priority_name 二選一）
          priority_name: 優先級名稱（與 priority_id 二選一）
          assigned_to_id: 指派給的用戶 ID（與 assigned_to_name/assigned_to_login 三選一）
          assigned_to_name: 指派給的用戶姓名（與 assigned_to_id/assigned_to_login 三選一）
          assigned_to_login: 指派給的用戶登入名（與 assigned_to_id/assigned_to_name 三選一）
      
      Returns:
          建立結果訊息
      """
      try:
          if not subject.strip():
              return "錯誤: 議題標題不能為空"
          
          client = get_client()
          
          # 處理追蹤器參數
          final_tracker_id = tracker_id
          if tracker_name:
              final_tracker_id = client.find_tracker_id_by_name(tracker_name)
              if not final_tracker_id:
                  return f"找不到追蹤器名稱：「{tracker_name}」\n\n可用追蹤器：\n" + "\n".join([f"- {name}" for name in client.get_available_trackers().keys()])
          
          # 處理優先級參數
          final_priority_id = priority_id
          if priority_name:
              final_priority_id = client.find_priority_id_by_name(priority_name)
              if not final_priority_id:
                  return f"找不到優先級名稱：「{priority_name}」\n\n可用優先級：\n" + "\n".join([f"- {name}" for name in client.get_available_priorities().keys()])
          
          # 處理指派用戶參數
          final_assigned_to_id = assigned_to_id
          if assigned_to_name:
              final_assigned_to_id = client.find_user_id_by_name(assigned_to_name)
              if not final_assigned_to_id:
                  users = client.get_available_users()
                  return f"找不到用戶姓名：「{assigned_to_name}」\n\n可用用戶（姓名）：\n" + "\n".join([f"- {name}" for name in users['by_name'].keys()])
          elif assigned_to_login:
              final_assigned_to_id = client.find_user_id_by_login(assigned_to_login)
              if not final_assigned_to_id:
                  users = client.get_available_users()
                  return f"找不到用戶登入名：「{assigned_to_login}」\n\n可用用戶（登入名）：\n" + "\n".join([f"- {login}" for login in users['by_login'].keys()])
          
          # 建立議題
          new_issue_id = client.create_issue(
              project_id=project_id,
              subject=subject.strip(),
              description=description,
              tracker_id=final_tracker_id,
              priority_id=final_priority_id,
              assigned_to_id=final_assigned_to_id
          )
          
          # 取得建立的議題資訊
          new_issue = client.get_issue(new_issue_id)
          
          result = f"""新議題建立成功!
  
  議題 ID: #{new_issue_id}
  標題: {new_issue.subject}
  專案: {new_issue.project.get('name', 'N/A')}
  追蹤器: {new_issue.tracker.get('name', 'N/A')}
  狀態: {new_issue.status.get('name', 'N/A')}
  優先級: {new_issue.priority.get('name', 'N/A')}
  指派給: {new_issue.assigned_to.get('name', '未指派') if new_issue.assigned_to else '未指派'}"""
  
          if description:
              result += f"\n\n描述:\n{description}"
  
          return result
          
      except RedmineAPIError as e:
          return f"建立議題失敗: {str(e)}"
      except Exception as e:
          return f"系統錯誤: {str(e)}"