insert_line_or_paragraph_near_text
Add a line or paragraph with specific formatting before or after a target paragraph in Microsoft Word documents. Specify by text or paragraph index for precise content placement.
Instructions
Insert a new line or paragraph (with specified or matched style) before or after the target paragraph. Specify by text or paragraph index. Args: filename (str), target_text (str, optional), line_text (str), position ('before' or 'after'), line_style (str, optional), target_paragraph_index (int, optional).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | ||
| line_style | No | ||
| line_text | No | ||
| position | No | after | |
| target_paragraph_index | No | ||
| target_text | No |
Implementation Reference
- word_document_server/main.py:563-568 (registration)MCP tool registration using @mcp.tool() decorator. Defines input schema via function parameters and docstring. Delegates execution to content_tools.insert_line_or_paragraph_near_text_tool.async def insert_line_or_paragraph_near_text(filename: str, target_text: Optional[str] = None, line_text: Optional[str] = None, position: str = 'after', line_style: Optional[str] = None, target_paragraph_index: Optional[int] = None): """ Insert a new line or paragraph (with specified or matched style) before or after the target paragraph. Specify by text or paragraph index. Args: filename (str), target_text (str, optional), line_text (str), position ('before' or 'after'), line_style (str, optional), target_paragraph_index (int, optional). """ return await content_tools.insert_line_or_paragraph_near_text_tool(filename, target_text, line_text, position, line_style, target_paragraph_index)
- Handler function in content_tools.py that receives tool call and delegates to the core utility function insert_line_or_paragraph_near_text in document_utils.py.async def insert_line_or_paragraph_near_text_tool(filename: str, target_text: str = None, line_text: str = "", position: str = 'after', line_style: str = None, target_paragraph_index: int = None) -> str: """Insert a new line or paragraph (with specified or matched style) before or after the target paragraph. Specify by text or paragraph index.""" return insert_line_or_paragraph_near_text(filename, target_text, line_text, position, line_style, target_paragraph_index)
- Core implementation: loads document, locates target paragraph by text or index (skipping TOC), creates new paragraph with matching/specified style, inserts before/after using low-level XML element manipulation (addprevious/addnext), saves the document.def insert_line_or_paragraph_near_text(doc_path: str, target_text: str = None, line_text: str = "", position: str = 'after', line_style: str = None, target_paragraph_index: int = None) -> str: """ Insert a new line or paragraph (with specified or matched style) before or after the target paragraph. You can specify the target by text (first match) or by paragraph index. Skips paragraphs whose style name starts with 'TOC' if using text search. """ import os from docx import Document if not os.path.exists(doc_path): return f"Document {doc_path} does not exist" try: doc = Document(doc_path) found = False para = None if target_paragraph_index is not None: if target_paragraph_index < 0 or target_paragraph_index >= len(doc.paragraphs): return f"Invalid target_paragraph_index: {target_paragraph_index}. Document has {len(doc.paragraphs)} paragraphs." para = doc.paragraphs[target_paragraph_index] found = True else: for i, p in enumerate(doc.paragraphs): # Skip TOC paragraphs if p.style and p.style.name.lower().startswith("toc"): continue if target_text and target_text in p.text: para = p found = True break if not found or para is None: return f"Target paragraph not found (by index or text). (TOC paragraphs are skipped in text search)" # Save anchor index before insertion if target_paragraph_index is not None: anchor_index = target_paragraph_index else: anchor_index = None for i, p in enumerate(doc.paragraphs): if p is para: anchor_index = i break # Determine style: use provided or match target style = line_style if line_style else para.style new_para = doc.add_paragraph(line_text, style=style) if position == 'before': para._element.addprevious(new_para._element) else: para._element.addnext(new_para._element) doc.save(doc_path) if anchor_index is not None: return f"Line/paragraph inserted {position} paragraph (index {anchor_index}) with style '{style}'." else: return f"Line/paragraph inserted {position} the target paragraph with style '{style}'." except Exception as e: return f"Failed to insert line/paragraph: {str(e)}"