Redmine MCP Server

Instructions

Implementation Reference

• src/redmine_mcp/server.py:1119-1164 (handler)

  The primary MCP tool handler for 'get_user'. Decorated with @mcp.tool() for automatic registration. Fetches user data from RedmineClient and formats it into a readable string response.
  @mcp.tool() def get_user(user_id: int) -> str: """ 取得特定用戶的詳細資訊 Args: user_id: 用戶 ID Returns: 用戶的詳細資訊，以易讀格式呈現 """ try: client = get_client() user_data = client.get_user(user_id) # 格式化用戶資訊 result = f"用戶 #{user_id}: {user_data.get('firstname', '')} {user_data.get('lastname', '')}\n\n" result += "基本資訊:\n" result += f"- 登入名: {user_data.get('login', 'N/A')}\n" result += f"- Email: {user_data.get('mail', 'N/A')}\n" result += f"- 狀態: {'啟用' if user_data.get('status', 1) == 1 else '停用'}\n" result += f"- 建立時間: {user_data.get('created_on', 'N/A')}\n" if user_data.get('last_login_on'): result += f"- 最後登入: {user_data.get('last_login_on')}\n" # 群組資訊 if user_data.get('groups'): result += "\n群組:\n" for group in user_data['groups']: result += f"- {group.get('name', 'N/A')}\n" # 自訂欄位 if user_data.get('custom_fields'): result += "\n自訂欄位:\n" for field in user_data['custom_fields']: if field.get('value'): result += f"- {field.get('name', 'N/A')}: {field.get('value', 'N/A')}\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:531-539 (helper)

  RedmineClient helper method that performs the actual API call to retrieve user details by ID from the Redmine server.
  def get_user(self, user_id: int) -> Dict[str, Any]: """取得特定用戶詳情""" response = self._make_request('GET', f'/users/{user_id}.json') if 'user' not in response: raise RedmineAPIError(f"找不到用戶 ID {user_id}") return response['user']
• src/redmine_mcp/server.py:1119-1119 (registration)

  The @mcp.tool() decorator registers the get_user function as an MCP tool.
  @mcp.tool()