MCP 服务器

LibreOffice MCP Server

Enables AI assistants to create, read, edit, and manipulate LibreOffice documents with support for track changes, comments, search/replace, and real-time document operations through a native extension or HTTP API.

README

LibreOffice MCP Server

A comprehensive Model Context Protocol (MCP) server that provides tools and resources for interacting with LibreOffice documents. This server enables AI assistants and other MCP clients to create, read, convert, and manipulate LibreOffice documents programmatically.

🚀 Features

LibreOffice Extension (Plugin) - Recommended!

Native Integration: Embedded MCP server directly in LibreOffice
Real-time Editing: Live document manipulation with instant visual feedback
Performance: 10x faster than external server (direct UNO API access)
9 Consolidated Tools: Reduced from 32 individual tools for better UX
Track Changes Support: Full revision tracking awareness
Multi-document: Work with all open LibreOffice documents
HTTP API: External AI assistant access via localhost:8765

Document Operations

Create Documents: New Writer, Calc, Impress, and Draw documents
Read Content: Extract text with visible_content for Track Changes awareness
Navigate: Paragraph-level navigation, cursor positioning, document outline
Edit: Insert, format, select, and replace text
Search: Find/replace with Track Changes awareness (skips tracked deletions)
Comments: Add and retrieve document annotations
Track Changes: Enable, disable, list, accept/reject revisions

🔧 9 Consolidated MCP Tools

The MCP interface provides 9 logical tool groups (consolidated from 32 individual tools):

Tool	Actions	Description
`document`	create, info, list, content, status	Document management
`structure`	outline, paragraph, range, count	Document navigation
`cursor`	goto_paragraph, goto_position, position, context	Cursor control
`selection`	paragraph, range, delete, replace	Text selection
`search`	find, replace, replace_all	Search/replace (Track Changes aware)
`track_changes`	status, enable, disable, list, accept, reject, accept_all, reject_all	Revision tracking
`comments`	list, add	Comment management
`save`	save, export	Save/export documents
`text`	insert, format	Text insertion and formatting

See docs/TOOL_REFERENCE.md for complete documentation.

📋 Requirements

LibreOffice: 24.2+ (must be accessible via command line)
Python: 3.12+
UV Package Manager: For dependency management

🛠 Installation

LibreOffice Extension (Recommended)

# Clone the repository
git clone https://github.com/jwingnut/mcp-libre.git
cd mcp-libre

# Build and install the LibreOffice extension
cd plugin/
./build.sh
unopkg add ../build/libreoffice-mcp-extension-1.0.0.oxt

# Restart LibreOffice

After installation:

Open LibreOffice Writer
Go to Tools > MCP Server > Start MCP Server
The HTTP API is now available at http://localhost:8765

FastMCP Bridge (for Claude Code)

# Install FastMCP
pip install fastmcp httpx

# Configure Claude Code
claude mcp add libreoffice -- fastmcp run /path/to/libreoffice_mcp_server.py

🎯 Quick Start

Using with Claude Code

Once configured, you can use natural language commands:

"Get document info"
→ document(action="info")

"Find all occurrences of 'hello'"
→ search(action="find", query="hello")

"Enable track changes"
→ track_changes(action="enable")

"Go to paragraph 5 and get context"
→ cursor(action="goto_paragraph", n=5)
→ cursor(action="context")

HTTP API Examples

# Check server status
curl http://localhost:8765/health

# Get document info
curl -X POST http://localhost:8765/tools/get_document_info_live -d '{}'

# Find text
curl -X POST http://localhost:8765/tools/find_text_live \
  -H "Content-Type: application/json" \
  -d '{"query": "hello"}'

# Enable Track Changes
curl -X POST http://localhost:8765/tools/set_track_changes_live \
  -H "Content-Type: application/json" \
  -d '{"enabled": true}'

📂 Repository Structure

mcp-libre/
├── plugin/                    # LibreOffice extension
│   ├── pythonpath/
│   │   ├── uno_bridge.py     # UNO API wrapper
│   │   └── mcp_server.py     # HTTP API server
│   ├── build.sh              # Build script
│   └── README.md             # Plugin documentation
├── libreoffice_mcp_server.py # FastMCP bridge (9 consolidated tools)
├── docs/
│   ├── TOOL_REFERENCE.md     # Complete tool documentation
│   └── KNOWN_ISSUES_AND_ROADMAP.md
├── src/                      # Legacy external server
├── tests/                    # Test suite
└── README.md