Redmine MCP Server

Instructions

取得所有可用的文件分類列表

Returns:
    格式化的文件分類列表

Implementation Reference

• src/redmine_mcp/server.py:383-412 (handler)

  MCP tool handler function for 'get_document_categories'. Decorated with @mcp.tool() for automatic registration. Fetches categories via Redmine client and formats as a formatted table string.

  @mcp.tool()
  def get_document_categories() -> str:
      """
      取得所有可用的文件分類列表
      
      Returns:
          格式化的文件分類列表
      """
      try:
          client = get_client()
          categories = client.get_document_categories()
          
          if not categories:
              return "沒有找到文件分類"
          
          result = "可用的文件分類:\n\n"
          result += f"{'ID':<5} {'名稱':<25} {'預設':<8}\n"
          result += f"{'-'*5} {'-'*25} {'-'*8}\n"
          
          for category in categories:
              is_default = "是" if category.get('is_default', False) else "否"
              result += f"{category['id']:<5} {category['name']:<25} {is_default:<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:432-436 (helper)

  Helper method in RedmineClient class that queries the Redmine API for document categories enumeration.

  def get_document_categories(self) -> List[Dict[str, Any]]:
      """取得文件分類列表"""
      response = self._make_request('GET', '/enumerations/document_categories.json')
      return response.get('document_categories', [])

• src/redmine_mcp/server.py:383-383 (registration)

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

  @mcp.tool()