docx-mcp

Instructions

Implementation Reference

• src/docx_mcp/server.py:1019-1059 (handler)

  The 'list_equations' tool handler is implemented in src/docx_mcp/server.py. It uses '@app.tool()' decorator to register the tool and calls 'extract_equations' to perform the logic.

  @app.tool()
  def list_equations(filepath: str) -> dict[str, Any]:
      """
      List all mathematical equations/formulas in a Word document.
  
      Extracts equations stored in Office Math Markup Language (OMML) format
      and converts them to LaTeX notation for readability.
  
      Args:
          filepath: Path to the document
  
      Returns:
          Dictionary with list of equations including LaTeX representation
      """
      logger.info("Listing equations", extra={"tool": "list_equations", "filepath": filepath})
  
      try:
          equations = extract_equations(filepath)
  
          return {
              "status": "success",
              "filepath": filepath,
              "equations": [
                  {
                      "index": eq["index"],
                      "paragraph_index": eq["paragraph_index"],
                      "type": eq["type"],
                      "latex": eq["latex"],
                      "context": eq["context"],
                  }
                  for eq in equations
              ],
              "count": len(equations),
          }
      except DocxMcpError as e:
          logger.warning(e.message, extra={"tool": "list_equations", "error_code": e.error_code})
          return {"status": "error", "error": e.message, "error_code": e.error_code}
      except Exception as e:
          logger.error(f"Unexpected error listing equations: {str(e)}")
          return {"status": "error", "error": str(e)}