Office Word MCP Server

Instructions

Implementation Reference

• word_document_server/main.py:430-434 (registration)

  Tool registration using FastMCP @mcp.tool() decorator. Thin wrapper that delegates to the format_tools.set_table_width implementation.
  @mcp.tool() def set_table_width(filename: str, table_index: int, width: float, width_type: str = "points"): """Set the overall width of a table.""" return format_tools.set_table_width(filename, table_index, width, width_type)
• word_document_server/tools/format_tools.py:825-893 (handler)

  Primary handler function that orchestrates the tool execution: validates inputs, loads document, converts user-friendly width units to Word XML format, calls core helper, saves document.
  async def set_table_width(filename: str, table_index: int, width: float, width_type: str = "points") -> str: """Set the overall width of a table. Args: filename: Path to the Word document table_index: Index of the table (0-based) width: Table width value width_type: Width type ("points", "inches", "cm", "percent", "auto") """ filename = ensure_docx_extension(filename) # Ensure numeric parameters are the correct type try: table_index = int(table_index) if width_type != "auto": width = float(width) except (ValueError, TypeError): return "Invalid parameter: table_index must be an integer, width must be a number" # Validate width type valid_width_types = ["points", "inches", "cm", "percent", "auto"] if width_type.lower() not in valid_width_types: return f"Invalid width type. Valid options: {', '.join(valid_width_types)}" if not os.path.exists(filename): return f"Document {filename} does not exist" # Check if file is writeable is_writeable, error_message = check_file_writeable(filename) if not is_writeable: return f"Cannot modify document: {error_message}. Consider creating a copy first." try: doc = Document(filename) # Validate table index if table_index < 0 or table_index >= len(doc.tables): return f"Invalid table index. Document has {len(doc.tables)} tables (0-{len(doc.tables)-1})." table = doc.tables[table_index] # Convert width and type for Word format if width_type.lower() == "points": word_width = width word_type = "dxa" elif width_type.lower() == "inches": word_width = width * 72 # 72 points per inch word_type = "dxa" elif width_type.lower() == "cm": word_width = width * 28.35 # ~28.35 points per cm word_type = "dxa" elif width_type.lower() == "percent": word_width = width word_type = "pct" else: # auto word_width = 0 word_type = "auto" # Apply table width success = set_table_width_func(table, word_width, word_type) if success: doc.save(filename) return f"Table width set successfully for table {table_index} to {width} {width_type}." else: return f"Failed to set table width." except Exception as e: return f"Failed to set table width: {str(e)}"
• word_document_server/core/tables.py:557-612 (helper)

  Core low-level helper that directly manipulates the Word document XML to set the &lt;w:tblW&gt; element in table properties, converting units to DXA or PCT as needed.
  def set_table_width(table, width, width_type="dxa"): """ Set the overall width of a table. Args: table: The table to modify width: Table width value width_type: Width type ("dxa" for points*20, "pct" for percentage*50, "auto") Returns: True if successful, False otherwise """ try: # Convert width based on type if width_type == "dxa": # DXA units (twentieths of a point) if isinstance(width, (int, float)): width_value = str(int(width * 20)) else: width_value = str(width) elif width_type == "pct": # Percentage (multiply by 50 for Word format) if isinstance(width, (int, float)): width_value = str(int(width * 50)) else: width_value = str(width) else: width_value = str(width) # Get table element and properties tbl = table._tbl # Get or create table properties tbl_pr = tbl.find(qn('w:tblPr')) if tbl_pr is None: tbl_pr = OxmlElement('w:tblPr') tbl.insert(0, tbl_pr) # Remove existing table width existing_width = tbl_pr.find(qn('w:tblW')) if existing_width is not None: tbl_pr.remove(existing_width) # Create new table width element width_element = OxmlElement('w:tblW') width_element.set(qn('w:w'), width_value) width_element.set(qn('w:type'), width_type) tbl_pr.append(width_element) return True except Exception as e: print(f"Error setting table width: {e}") return False