Redmine MCP Server

Instructions

搜尋用戶（依姓名或登入名）

Args:
    query: 搜尋關鍵字（姓名或登入名）
    limit: 最大回傳數量 (預設 10，最大 50)

Returns:
    符合搜尋條件的用戶列表

Implementation Reference

• src/redmine_mcp/server.py:1028-1069 (handler)

  MCP tool handler for search_users: formats client results into a readable table string.

  @mcp.tool()
  def search_users(query: str, limit: int = 10) -> str:
      """
      搜尋用戶（依姓名或登入名）
      
      Args:
          query: 搜尋關鍵字（姓名或登入名）
          limit: 最大回傳數量 (預設 10，最大 50)
      
      Returns:
          符合搜尋條件的用戶列表
      """
      try:
          if not query.strip():
              return "請提供搜尋關鍵字"
          
          client = get_client()
          limit = min(max(limit, 1), 50)
          
          users = client.search_users(query, limit)
          
          if not users:
              return f"沒有找到匹配「{query}」的用戶"
          
          result = f"搜尋關鍵字: '{query}'\n找到 {len(users)} 個相關用戶:\n\n"
          result += f"{'ID':<5} {'登入名':<15} {'姓名':<20} {'狀態':<8}\n"
          result += f"{'-'*5} {'-'*15} {'-'*20} {'-'*8}\n"
          
          for user in users:
              full_name = f"{user.firstname} {user.lastname}".strip()
              if not full_name:
                  full_name = user.login
              status_text = "啟用" if user.status == 1 else "停用"
              result += f"{user.id:<5} {user.login:<15} {full_name:<20} {status_text:<8}\n"
          
          return result
          
      except RedmineAPIError as e:
          return f"搜尋用戶失敗: {str(e)}"
      except Exception as e:
          return f"系統錯誤: {str(e)}"

• src/redmine_mcp/redmine_client.py:504-530 (helper)

  RedmineClient.search_users: performs API call to /users.json with name=query param and parses into RedmineUser objects.

  def search_users(self, query: str, limit: int = 10) -> List[RedmineUser]:
      """搜尋用戶（依姓名或登入名）"""
      if not query.strip():
          return []
          
      params = {
          'name': query.strip(),
          'limit': min(max(limit, 1), 50)
      }
      
      response = self._make_request('GET', '/users.json', params=params)
      
      users = []
      for user_data in response.get('users', []):
          users.append(RedmineUser(
              id=user_data['id'],
              login=user_data['login'],
              firstname=user_data.get('firstname', ''),
              lastname=user_data.get('lastname', ''),
              mail=user_data.get('mail', ''),
              status=user_data.get('status', 1),
              created_on=user_data.get('created_on'),
              last_login_on=user_data.get('last_login_on')
          ))
      
      return users

• src/redmine_mcp/redmine_client.py:48-58 (helper)

  Dataclass defining RedmineUser structure used by search_users.

  class RedmineUser:
      """Redmine 用戶數據結構"""
      id: int
      login: str
      firstname: str
      lastname: str
      mail: str
      status: int
      created_on: Optional[str] = None
      last_login_on: Optional[str] = None