Office Word MCP Server

Instructions

Implementation Reference

• word_document_server/main.py:452-457 (registration)

  Tool registration using @mcp.tool() decorator. Defines the tool schema via function parameters and docstring.
  def set_table_cell_padding(filename: str, table_index: int, row_index: int, col_index: int, top: float = None, bottom: float = None, left: float = None, right: float = None, unit: str = "points"): """Set padding/margins for a specific table cell.""" return format_tools.set_table_cell_padding(filename, table_index, row_index, col_index, top, bottom, left, right, unit)
• word_document_server/tools/format_tools.py:1025-1113 (handler)

  Primary handler function executing the core tool logic: parameter validation, DOCX loading, table/cell access validation, unit conversion, helper invocation, document save, and response formatting.
  async def set_table_cell_padding(filename: str, table_index: int, row_index: int, col_index: int, top: Optional[float] = None, bottom: Optional[float] = None, left: Optional[float] = None, right: Optional[float] = None, unit: str = "points") -> str: """Set padding/margins for a specific table cell. Args: filename: Path to the Word document table_index: Index of the table (0-based) row_index: Row index (0-based) col_index: Column index (0-based) top: Top padding in specified units bottom: Bottom padding in specified units left: Left padding in specified units right: Right padding in specified units unit: Unit type ("points" or "percent") """ filename = ensure_docx_extension(filename) # Ensure numeric parameters are the correct type try: table_index = int(table_index) row_index = int(row_index) col_index = int(col_index) if top is not None: top = float(top) if bottom is not None: bottom = float(bottom) if left is not None: left = float(left) if right is not None: right = float(right) except (ValueError, TypeError): return "Invalid parameter: indices must be integers, padding values must be numbers" # Validate unit valid_units = ["points", "percent"] if unit.lower() not in valid_units: return f"Invalid unit. Valid options: {', '.join(valid_units)}" 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] # Validate row and column indices if row_index < 0 or row_index >= len(table.rows): return f"Invalid row index. Table has {len(table.rows)} rows (0-{len(table.rows)-1})." if col_index < 0 or col_index >= len(table.rows[row_index].cells): return f"Invalid column index. Row has {len(table.rows[row_index].cells)} cells (0-{len(table.rows[row_index].cells)-1})." # Convert unit for Word format word_unit = "dxa" if unit.lower() == "points" else "pct" # Apply cell padding success = set_cell_padding_by_position(table, row_index, col_index, top, bottom, left, right, word_unit) if success: doc.save(filename) padding_desc = [] if top is not None: padding_desc.append(f"top={top}") if bottom is not None: padding_desc.append(f"bottom={bottom}") if left is not None: padding_desc.append(f"left={left}") if right is not None: padding_desc.append(f"right={right}") padding_str = ", ".join(padding_desc) if padding_desc else "no padding" return f"Cell padding set successfully for table {table_index}, cell ({row_index},{col_index}): {padding_str} {unit}." else: return f"Failed to set cell padding. Check that indices are valid." except Exception as e: return f"Failed to set cell padding: {str(e)}"
• word_document_server/core/tables.py:839-867 (helper)

  Supporting helper that resolves cell by row/col position and delegates to lower-level set_cell_padding function.
  def set_cell_padding_by_position(table, row_index, col_index, top=None, bottom=None, left=None, right=None, unit="dxa"): """ Set padding for a specific table cell by position. Args: table: The table containing the cell row_index: Row index (0-based) col_index: Column index (0-based) top: Top padding value bottom: Bottom padding value left: Left padding value right: Right padding value unit: Unit type ("dxa" for twentieths of a point, "pct" for percentage) Returns: True if successful, False otherwise """ try: if (0 <= row_index < len(table.rows) and 0 <= col_index < len(table.rows[row_index].cells)): cell = table.rows[row_index].cells[col_index] return set_cell_padding(cell, top, bottom, left, right, unit) else: return False except Exception as e: print(f"Error setting cell padding by position: {e}") return False