Office MCP Server

The Office MCP Server is an unofficial Model Context Protocol (MCP) Server based Java server designed to manage and process requests from AI agents for Word, Excel, etc. files.

Framework

This project is built using Quarkus, a Kubernetes-native Java framework tailored for building lightweight, high-performance microservices. Quarkus enables fast startup times and low memory usage, making it ideal for cloud-native applications.

Supported Methods

The server supports the following MCP tools and resources:

Excel Features

• Tool: Get Filename: Retrieve the filename of an Excel file.
  • Argument: filename - The name of the Excel file.
• Tool: Create Excel Workbook: Create a new Excel workbook.
  • Argument: filepath - Path to create the new Excel workbook.
• Tool: Create Excel Sheet: Create a new sheet in an Excel workbook.
  • Arguments:
    • filepath - Path to the Excel workbook.
    • sheetName - Name of the new sheet.
• Tool: Add Excel Row: Add a row to an Excel sheet.
  • Arguments:
    • filepath - Path to the Excel workbook.
    • sheetName - Name of the sheet.
    • rowData - Data for the new row.
• Tool: Read Excel Cell: Read a cell from an Excel sheet.
  • Arguments:
    • filepath - Path to the Excel workbook.
    • sheetName - Name of the sheet.
    • rowNum - Row number (0-based).
    • colNum - Column number (0-based).
• Tool: Close Excel Workbook: Close an Excel workbook.
  • Argument: filepath - Path to the Excel workbook.
• Tool: Get Excel Sheet Count: Get the number of sheets in an Excel workbook.
  • Argument: filepath - Path to the Excel workbook.
• Tool: Get Excel Row Count: Get the number of rows in a sheet.
  • Arguments:
    • filepath - Path to the Excel workbook.
    • sheetName - Name of the sheet.
• Tool: Get Excel Column Count: Get the number of columns in a sheet.
  • Arguments:
    • filepath - Path to the Excel workbook.
    • sheetName - Name of the sheet.

Word Features

• Tool: Create Word Document: Create a new Word document.
  • Argument: filepath - Path to create the new Word document.
• Tool: Add Text to Word Document: Add text to a Word document.
  • Arguments:
    • filepath - Path to the Word document.
    • text - Text to add.

PowerPoint Features

• Tool: Create PowerPoint Presentation: Create a new PowerPoint presentation.
  • Argument: filepath - Path to create the new PowerPoint presentation.
• Tool: Add Slide to PowerPoint: Add a new slide to a PowerPoint presentation.
  • Argument: filepath - Path to the PowerPoint presentation.
• Tool: Add Text to PowerPoint Slide: Add text to a specific slide in a PowerPoint presentation.
  • Arguments:
    • filepath - Path to the PowerPoint presentation.
    • slideIndex - Slide index (0-based).
    • text - Text to add.
• Tool: Read Slide Titles from PowerPoint: Read titles from all slides in a PowerPoint presentation.
  • Argument: filepath - Path to the PowerPoint presentation.
• Tool: Get PowerPoint Slide Count: Get the number of slides in a PowerPoint presentation.
  • Argument: filepath - Path to the PowerPoint presentation.

How to Debug and Run Standalone

To run the Office MCP Server, follow these steps:

1. Build the application: Ensure you have Maven installed. Run the following command to build the project:

   $ ./mvnw clean package
   

2. Run the application: After building, execute the following command to start the server:

   $ java -jar target/office-mcp-server-0.0.1-SNAPSHOT-runner.jar
   

3. Access the application: The server will start on the default port 8080. You can access the APIs at:

   http://localhost:8080
   

4. Run in development mode: For development purposes, you can use Quarkus's de

... View full README on GitHub